API reference

Every Partners API endpoint, with its parameters, responses and samples in curl, Node.js and Python. Generated from the same specification the API is built from.

Base URL

Environment	Base URL
Sandbox	`https://staging.lint.finance/api/partner/v1`
Live	`https://api.lint.finance/api/partner/v1`

Samples on these pages call the sandbox. Swap the base URL and your keys to go live.

Authentication

Every endpoint except POST /oauth/token needs a bearer token:

Authorization: Bearer <access_token>

See Authentication for getting and refreshing tokens.

Resources

Authentication Exchange client credentials for a token.Virtual accounts One-time accounts that collect a single payment.Customers The people and businesses you hold wallets for.Identity BVN verification with an OTP.Wallets Wallets with their own account numbers, and payouts.Bills Airtime, data, electricity, cable TV and more.Banks Bank codes and name enquiry.Transactions Every movement of money on your account.

Before you build

Read Conventions (amounts are in kobo), Errors (branch on code) and Idempotent requests (how to retry payouts safely).