API reference
Banks
Bank codes for payouts, and name enquiry to confirm an account before paying it.
Look up the name on a bank account
POST/api/partner/v1/banks/resolve-account
Name enquiry: confirms a bank account exists and returns the account holder's name. Show it to your user before sending a payout.
Body
- bank_codestringrequired
Example:
"000013" - account_numberstringrequired
Example:
"0123456789"
Responses
- 200Account found
- 401Missing, invalid or expired access token.
unauthenticated - 422Validation failed or the account could not be found.
validation_failedaccount_resolution_failedinsufficient_balance
curl -X POST https://staging.lint.finance/api/partner/v1/banks/resolve-account \
-H "Authorization: Bearer $LINT_ACCESS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"bank_code": "000013",
"account_number": "0123456789"
}'Response · 200
{
"status": "success",
"message": "Account resolved",
"data": {
"account_number": "0123456789",
"account_name": "ADA OBI",
"account_bank": "GTBank",
"bank_code": "000013",
"resolved": true
}
}List banks
GET/api/partner/v1/banks/{countryCode}
Banks you can send payouts to, with the code to pass as credit_account_bank_code.
Path parameters
- countryCodestringrequired
ISO 3166-1 alpha-2 country code. Only
ngis supported.Example:
"ng"
Responses
- 200Banks
- 401Missing, invalid or expired access token.
unauthenticated - 404The resource does not exist or belongs to another partner. The two cases are indistinguishable by design.
not_found
curl -X GET https://staging.lint.finance/api/partner/v1/banks/ng \
-H "Authorization: Bearer $LINT_ACCESS_TOKEN" \
-H "Accept: application/json"Response · 200
{
"data": [
{}
],
"status": "success",
"message": "Banks returned successfully"
}