Payout

With the endpoints here, you can make payments to other banks.
Please note that to use the signature endpoint and the transfer to other banks via API, you need to be approved by the compliance team.

Account Enquiry

Use this to reconfirm bank account name for transfers
Request Sample
1curl --location 'https://pocket.seerbitapi.com/pocket/payout/account-enquiry' \
2--header 'Content-Type: application/json' \
3--header 'Authorization: Bearer YOUR_BEARER_TOKEN_HERE' \
4--data-raw '
5	{ 
6    "accountnumber":"(account number)", 
7    "bankcode":"(bank code)" 
8}'

Bank List

This API shows a list of supported Nigerian banks
1curl --location 'https://pocket.seerbitapi.com/pocket/banks' \
2--header 'Content-Type: application/json' \
3--header 'Authorization: Bearer YOUR_BEARER_TOKEN_HERE' \
4--header 'Public-Key: your_public_key_here' \

Generate OTP

An OTP is required to authorize a payout transaction. Use the `Get OTP` endpoint.
Note: The OTP provided in the \`otp\` field should be passed as the \`passKey\` in the generate
signature and payout request.,
Request Sample
1curl --location 'https://pocket.seerbitapi.com/pocket/getOtp' \
2--header 'Public-Key: your_public_key_here' \
3--header 'Content-Type: application/json' \
4--header 'Authorization: Bearer your_bearer_token_here' \
5--data-raw '
6	{ 
7  	"actionItem": "APPROVE_DISBURSEMENT", 
8  	"pocketId": "your_pocket_id_here" 
9}' 
Response Sample
This a sample response code
1{ 
2	"responseCode" : "00", 
3	"message" : "Success", 
4	"data" : { 
5		"otp" : "028087” 
6		"category" : "APPROVE_DISBURSEMENT", 
7		"expires" : "2025-02-25T19:20:12.649104071" 
8	} 
9}

Generate Signature

Instead of manually creating a signature, use the `Get Signature` endpoint.
1curl --location 'https://pocket.seerbitapi.com/pocket/payout/get-signature' \
2--header 'Content-Type: application/json' \
3--header 'Authorization: Bearer {{bearerToken}}' \
4--data '
5{ 
6	"reference": "JIN-12345678901101", 
7	"amount": "10", 
8	"currency": "NGN", 
9	"description": "test", 
10	"accountNumber": "{{accountNumber}}", 
11	"bankCode": "000013", 
12	"actionType": "APPROVE_DISBURSEMENT", 
13	"passKey": "028087" 
14}'
Response Sample
This a sample response code
1{ 
2	"responseCode" : "00", 
3	"message" : "Success", 
4	"data" : "
5    	{
6        {signature}
7      }" 
8} 
Note: The value in the `data` field is the generated signature. This signature changes for every
transaction.  payout request from their pocket to multiple bank accounts. It will generate a batch ID, which can be queried to get the status of the transactions within the batch.

Inititate Payout

Use the `Initiate Payout` endpoint, passing the generated signature in the request body.
Request Sample
1curl --location 'https://pocket.seerbitapi.com/pocket/payout/encrypted/pocket-id/{{pocketID}}' \
2--header 'Content-Type: application/json' \
3--header 'Public-Key: {{publicKey}}' \
4--header 'Authorization: Bearer {{bearerToken}}' \
5--data '
6	{ 
7		"reference": "JIN-12345678901101", 
8		"amount": "10", 
9		"currency": "NGN","description": "test", 
10		"accountNumber": "{{accountNumber}}", 
11		"bankCode": "000013", 
12		"passKey": "028087", 
13		"actionType": "APPROVE_DISBURSEMENT", 
14		"signature": "{{signature}}" 
15	}' 
16    
Response Sample
This a sample response code
1{ 
2	"responseCode" : "00", 
3	"message" : "Successful", 
4	"data" : 
5    { 
6		"reference" : "JIN-12345678901101", 
7		"linkingreference" : "F00230472990" 
8	} 
9} 
Need something else?
If you have any questions or need general help, visit our support page
Signup for developer update
You can unsubscribe at any time. Read our privacy policy.