curl -X POST "https://api.tabsglobal.co/v1/beneficiaries" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN"
}
}'
const response = await fetch("https://api.tabsglobal.co/v1/beneficiaries", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "BANK_ACCOUNT",
details: {
accountName: "ADEWALE ADELEKE",
accountNumber: "0123456789",
bankCode: "058",
currency: "NGN",
},
}),
});
const beneficiary = await response.json();
console.log(beneficiary);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/beneficiaries",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN",
},
},
)
print(response.json())
{
"id": "ben_4a8e2b1c-9f0d-4e5a-8b2c-1d0f3a4b5c6d",
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN"
},
"createdAt": "2026-09-21T01:30:00.000Z"
}
Beneficiaries API
Save a Beneficiary
Save a validated payout recipient for repeat transfers.
POST
/
v1
/
beneficiaries
curl -X POST "https://api.tabsglobal.co/v1/beneficiaries" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN"
}
}'
const response = await fetch("https://api.tabsglobal.co/v1/beneficiaries", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "BANK_ACCOUNT",
details: {
accountName: "ADEWALE ADELEKE",
accountNumber: "0123456789",
bankCode: "058",
currency: "NGN",
},
}),
});
const beneficiary = await response.json();
console.log(beneficiary);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/beneficiaries",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN",
},
},
)
print(response.json())
{
"id": "ben_4a8e2b1c-9f0d-4e5a-8b2c-1d0f3a4b5c6d",
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN"
},
"createdAt": "2026-09-21T01:30:00.000Z"
}
Saves a recipient’s banking or wallet credentials to your merchant profile.
Scopes required
beneficiaries:write or *
Headers
string
required
Bearer API secret key formatted as
Bearer sk_live_... or Bearer sk_test_....Body
string
required
Recipient category:
BANK_ACCOUNT or CRYPTO_WALLET.object
required
Response
string
Unique beneficiary identifier.
string
Beneficiary type.
object
Saved recipient details.
string
Creation timestamp.
curl -X POST "https://api.tabsglobal.co/v1/beneficiaries" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN"
}
}'
const response = await fetch("https://api.tabsglobal.co/v1/beneficiaries", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "BANK_ACCOUNT",
details: {
accountName: "ADEWALE ADELEKE",
accountNumber: "0123456789",
bankCode: "058",
currency: "NGN",
},
}),
});
const beneficiary = await response.json();
console.log(beneficiary);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/beneficiaries",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN",
},
},
)
print(response.json())
{
"id": "ben_4a8e2b1c-9f0d-4e5a-8b2c-1d0f3a4b5c6d",
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"currency": "NGN"
},
"createdAt": "2026-09-21T01:30:00.000Z"
}
