Log in
Recent Requests
Make a request to see history.
Step 1 of every payment — a payment link, a C2B Direct payment or a QR payment. Send your API key from the merchant portal (Developer → API keys) and get a token.
In Try it: in the merchant portal click Copy API key, paste it into apiKey under Body, and click Try It!. Paste the whole key; Try it splits it for you.
From the response you get:
| Value | Use it for |
|---|---|
headerValue | The token for every payment call. Try it fills it in on every payment page for you; Copy token copies it. |
tenantId | The tenantId of every payment call. Try it fills it in for you too. |
The token works until expires — about 15 minutes. Reuse it for every payment until then. After that, payment calls return 401: log in again.
Body#
Filled in from your API key.
Filled in from your API key.
Response#
Bearer <token> — send it as the Authorization header on every payment call.
Your tenant ID — use it in the URL of every payment call.
When the token stops working (about 15 minutes).
Always Authorization.
Next: create a payment link, or open a C2B Direct method — M-Pesa, Dashen Bank, Nib Bank, telebirr, telebirr QR, EthSwitch or Zemen Bank.
Your API key is a password. In your own code, call Log in from your server only — never from a mobile app or a website.