Credits and billing

GetSMS is prepaid. You buy a credit pack in dirhams, then each SMS you send is debited from your balance. No subscription, and credits never expire.

Packs

Pack	Price excl. VAT	SMS included	Price per SMS
Starter	100 DH	500	0.20 DH
Pro	450 DH	2,500	0.18 DH
Business	1,500 DH	10,000	0.15 DH

20% VAT is added to the price excluding VAT. The best price per SMS you have reached stays yours: after a Business pack, your sends cost 0.15 DH, even if you later top up with a Starter pack.

What gets charged

• All or nothing. A bulk send is accepted only if your balance covers all of its messages.
• One charge per segment. An SMS of 160 GSM-7 characters counts as 1 segment; beyond that, each segment holds 153 characters. With a character outside GSM-7 (emoji, Arabic, some accented letters), a segment holds 70 characters, then 67.
• When the API accepts the message. If your balance is too low, the send is rejected with a 402 error and nothing is queued.
• Refunded if the SMS did not go out. A failed (failed) or expired (expired) message is credited back automatically, once.
• Never in the sandbox. Messages sent with the test key are free and unlimited.
• Not during the trial. Until your business is verified, your 20 trial SMS are free. Credits are used after that.

402 response

{
  "status": "error",
  "code": "insufficient_credit",
  "message": "crédit insuffisant : cet envoi coûte 0,36 DH HT et votre solde est de 0,12 DH ; achetez un pack dans Facturation",
  "data": { "balance": 120, "required": 360, "unit_price": 180 }
}

API amounts are in thousandths of a dirham (1 DH = 1,000), excluding VAT. In the example, 0.12 DH is left and the 2-segment message costs 0.36 DH.

Pay

From the dashboard, in Settings → Billing:

• Bank card: 3-D Secure payment on the CMI secure page. GetSMS never sees your card number. Credits are added as soon as the bank confirms.
• Bank transfer: you receive the RIB (bank details) and a reference to put in the transfer description. Credits are added as soon as we receive the transfer, usually within 24 to 48 business hours.

Invoices

Each payment produces a numbered PDF invoice with VAT itemized. It shows the company name, ICE and address from your verification file. Invoices can be downloaded in Settings → Billing.

Balance via the API

curl https://api.getsms.tech/v1/billing/wallet \
  -H "x-api-key: $GETSMS_API_KEY"

{
  "status": "success",
  "data": { "balance": 412360, "unit_price": 180, "sms_estimate": 2290, "low": false, "billing_enabled": true, "debits_active": true, "currency": "MAD" }
}

low turns true when fewer than 50 SMS are left: a good time to top up. debits_active tells you whether your real sends are being charged right now (verified business).