POS integration · Message customers
Any SMS provider with a web API, called from your POS
Custom SMS gateway POS integration in ArmPOS texts your customers through any provider with a web API. ArmPOS calls your Gateway URL and puts {phone}, {message} and {sender} where your provider expects them.
- Your provider’s Gateway URL
- JSON or form, GET, POST or PUT
- A Success word you choose
- Built in
How ArmPOS calls your SMS provider
- Someone clicks SMSon a sale, a quote or a payment
- Your fields filled in{phone}, {message} and {sender}
- A call to your Gateway URLby GET, POST or PUT
- Your provider answersa 2xx, with your Success word
What ArmPOS does with Custom SMS gateway, step by step
- ArmPOS sends one HTTP request to your Gateway URL for each text, by the Method you pick: POST, GET or PUT
- Your Body fields go as JSON or as a form, by your Content type, or in the query string for a GET
- In your Headers and Body fields, {phone}, {message} and {sender} become the number, the text and your Sender
- A text counts as sent only on a 2xx answer, and only if that answer holds your Success word when you set one
- Your phone number and Send make that same request once, with a test text to you
What your gateway receives, and what counts as sent
One request per text, each one when someone clicks SMS.
- Receipts, quotes and paymentsSMS on a sale, a quotation or a payment, each with its own template.
- Your provider’s own field namesEach header and body field takes the name your provider’s API uses.
- A key or token in a headerAdd it under Headers, such as Authorization, as your provider asks.
- A 2xx without your Success wordArmPOS treats the text as failed, because the word wasn’t in the answer.
- An answer outside 2xxThe text is reported as not sent.
- Delivery reportsArmPOS reads only the first answer, never a callback.
Saving the Custom SMS gateway makes it the provider every text uses. Termii, Twilio and Infobip keep their saved details.
Where it works, and for whom
Countries
- Wherever your SMS provider sends texts
For
- Retail & grocery
- Fashion & beauty
- Health & pharmacy
- Phones & electronics
- Hardware & building materials
- Wholesale & distribution
- Hospitality
Set up in 3 steps
- Open Integrations › Message customers › Text messages, click Set up, and choose Custom SMS gateway.
- Type the Gateway URL and your Sender. Under More settings, set the Method, Content type, Headers and Body fields.
- Click Save, then type your phone number and click Send to test the request.
Words you’ll see on the screens
- Custom SMS gateway
- Gateway URL
- Sender
- More settings
- Method
- Content type
- Success word
- Headers
- Body fields
- Add a line
- Your phone number
- Send
What it doesn’t do
- It speaks plain HTTP only: no SMPP connection, and no provider’s SDK.
- It adds no country code: {phone} is the number exactly as it’s saved on the customer.
- Delivery reports and replies don’t come back, since ArmPOS reads only your provider’s first answer.
Questions
What is a Custom SMS gateway in ArmPOS?
It’s for any SMS gateway API that isn’t Termii, Twilio or Infobip. You describe the request once, and ArmPOS makes it for every text.
How do I connect my SMS provider’s API to my POS?
Choose Custom SMS gateway in Text messages. Type the Gateway URL and Sender, then add your provider’s Headers and Body fields under More settings.
Where do the phone number and the message go?
Write {phone}, {message} and {sender} as values in your Headers or Body fields. ArmPOS swaps them for the real number, text and Sender.
Can my provider take a GET request?
Yes. Pick GET as the Method and put every parameter in Body fields. They become the query string, replacing any written in the Gateway URL.
How does ArmPOS know a text was sent?
Your provider must answer with a 2xx status. With a Success word set, its answer must also contain that word.
How do I send my provider’s API key?
Add it as a header, such as Authorization, or as a body field, whichever your provider’s web API documentation asks for.
Can I test the gateway before texting customers?
Yes. After saving, type your phone number and click Send. ArmPOS makes the real request with a test text.
Works well with
Get Started
Run your shop on ArmPOS
Start free with point of sale and inventory management in one app. No card needed; upgrade when your business grows.
- 14-day free trial
- No card needed
- Android & iPhone
