Introduction

Nablr for Business lets your website or app take payments in naira. Your customer pays by card, bank transfer, USSD or Pay with Nablr. You get a webhook, check the payment with one API call, and the money settles to your balance.

These docs cover everything you need to integrate: the guides walk through each step, and the API reference lists every endpoint.

How a payment works

1. Your customer clicks Pay on your site.
2. Your server initialises the payment: POST /v1/payments with the amount, a reference and the customer’s email, using your secret key.
3. We answer with a checkout_url and a checkout_token.
4. You send the customer to the hosted checkout at checkout_url, or open the same checkout over your page with the inline script.
5. The customer pays. The checkout handles card details, one-time codes, transfer accounts, USSD codes and Pay with Nablr approvals, so your site never touches them.
6. We send a payment.succeeded webhook to your server.
7. The checkout sends the customer back to your callback_url with ?reference=….
8. Your server verifies the payment: GET /v1/payments/{reference}.
9. Only when the status is succeeded and the amount is right do you give value: ship the order, top up the account, issue the ticket.

Steps 6 and 7 can arrive in either order, and either can fail to arrive (a customer closes the tab; a network drops a webhook). Your server must act on whichever comes first, and verify every time.

Base URLs

Environment	API base URL	Keys
Production	https://api.paywithnablr.com/v1	sk_test_… and sk_live_…
Pre-launch test server	https://pwn-api.142-93-42-70.sslip.io/v1	sk_test_… from the test dashboard

The key decides the mode, not the URL: a test key only ever sees test data and moves no money. Until launch, build against the test server with a test key from the test dashboard.

What you can build today

• Hosted checkout: redirect to our page.
• Inline checkout: the same checkout in an overlay on your page.
• Payment links: a shareable page, no code needed.
• Webhooks: signed notifications when payments succeed or fail.
• Payment methods: card, bank transfer, USSD and Pay with Nablr.

Refunds, payouts, virtual accounts, subscriptions and SDKs are coming soon.

Next steps

Quick startTake your first test payment in five minutes.

Test modeTest cards, amounts and Nablr payers for every outcome.

WebhooksGet told when a payment succeeds, and check it is really us.

Going liveVerify your business and switch to live keys.