Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

API authentication with bearer tokens

Every request is authenticated with an API token sent in the Authorization header. One token belongs to one business wallet.
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

Get a token

Your business must be onboarded for the API first. Contact business@sendcheap.ng to enable the products you need (bills, collections, transfers, crypto, KYC).
  1. Open API settings
    Sign in to the SendCheap app with your business account and open API keys.
  2. Add your server details
    Enter your server IP addresses and your webhook URL (see Webhooks).
  3. Generate the token
    Copy the token and store it as a secret on your server.
Treat the token like a password. Anyone holding it can spend from your wallet.

Rotate a token

Regenerating issues a new token and immediately invalidates the old one. Deploy the new token to your servers right after regenerating, or requests will start failing.

Authentication errors

A missing, malformed, revoked or regenerated token returns HTTP 406:
{ "status": "failed", "message": "Unauthorized", "data": null }
Some endpoints also check that your business is enabled for that product and answer with HTTP 400:
{ "status": "failed", "message": "you are not onboarded for this service... contact support", "data": null }
Suspended profiles cannot generate or use tokens. Contact support if you see profile suspended... please contact support....