One account number per payment.
Create a transaction, show your customer the account number, and get paid the moment the transfer lands. Confirmed by webhook, polling or a live event, and settled to your bank.
Pay exactly
To account number
9 9 1 2 3 4 5 6 7 8
- Bank
- Partner Bank
- Account name
- ACME STORES / YUSR
- Status
- Waiting for transfer
- Expires in
- --:--
Transfer exactly this amount to the account above before it expires.
Follow one payment from the API call to your bank account: order-1042, for ₦25,000.00.
Step 1: Create a transaction
14:00:00₦25,000.00 requested
Your server sends the amount in kobo and your own reference. The response carries a one-time account number reserved for this payment, the fee quoted up front, and a link to a hosted payment page.
Amounts are integers from the request to the settlement.
Step 2: Your customer transfers
14:06:40₦25,000.00 sent
They pay from any Nigerian bank app: ten digits and an exact amount. The account name carries your business name, so they recognise who they are paying.
In your own checkout
Show the four fields from
payment: account number, bank, account name and amount.Or send a link
Every transaction has a
checkout_url. It opens a hosted page with the same details, a countdown and the live status, under your name, logo and brand colour.
Address: pay.yusr.ng/pay_Zk3xV9qLm2Rt7YwB4nHs8dJc6uPa1eGf
Acme Stores
Pay exactly
To account number
9 9 1 2 3 4 5 6 7 8
- Bank
- Partner Bank
- Account name
- ACME STORES / YUSR
- Status
- Waiting for transfer
- Expires in
- --:--
- Reference
- order-1042
Transfer exactly this amount to the account above before it expires.
Step 3: The payment is confirmed
14:07:12₦25,000.00 received
The transfer is matched to the transaction by its account number, with no narration to read. You hear about it three ways, and all three carry the same transaction object.
Use the webhook to fulfil the order, the live event to update the page your customer is looking at, and polling as the fallback.
| Webhook | Polling | Realtime | |
|---|---|---|---|
| Use it for | Fulfilment | A fallback | The checkout page |
| How it arrives | Signed POST to your server | GET the transaction by id or reference | Event on a socket |
| Delivery | At least once, retried for 22 hours | On request | On every change |
| Authenticates with | Webhook secret | Secret key | Short-lived client token |
Step 4: Your money is settled
T+0 or T+1₦24,625.00 to your bank
The fee comes off as the payment is booked and the rest is credited to your balance. Settlement pays that balance to your verified bank account on the schedule agreed when you go live.
Each settlement lists the transactions in it, with gross, fee and net, in the dashboard, as CSV and by API.
- Received for order-1042
- ₦25,000.00
- Fee, 1.5% capped at ₦2,000.00
- −₦375.00
- Settled to your bank
- ₦24,625.00
A worked example on the published plan.
1.5%capped at ₦2,000.00 per successful transfer.
No setup fee, no monthly fee, nothing for expired or cancelled transactions. From ₦133,333.34 upwards every transfer costs the capped amount.
Built so the money arrives
Current availability is on the status page.
Signed webhooks
Every delivery is signed with HMAC-SHA256 over a timestamp and the raw body. Replays older than five minutes are rejected.
Idempotency keys
Retry a create call with the same Idempotency-Key and you get the original response back. A network blip never makes two accounts.
Two-factor sign-in
Owners and Admins must use two-factor authentication. Secret keys are shown once and stored only as hashes; live keys take IP allowlists.
Encrypted verification files
Business verification documents and sensitive personal fields are encrypted at rest. Traffic is encrypted in transit with TLS.
Append-only ledger
Every payment is booked in a double-entry ledger that is reconciled daily. Nothing is lost, counted twice or settled twice.
Audit log
Key rolls, webhook changes, settings and team changes are written to an audit log you can read in the dashboard.
Start in the sandbox today
Test keys are issued the moment you sign up. Simulate paid, underpaid, overpaid, late and expired transfers, then go live once your business is verified.