Transfer
A collection of endpoints for automating sending money to beneficiaries
Copy link List Transfers
List the transfers made on your integration
Query Parameters
Response
5 object properties
/transfercurl https://api.paystack.co/transfer \
-H "Authorization: Bearer YOUR_SECRET_KEY"import { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.list({
use_cursor: true,
next: "NEXT"
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.list({
use_cursor: true,
next: "NEXT"
})
puts response.data{
"status": true,
"message": "Transfers retrieved",
"data": [
{
"integration": 100073,
"recipient": {
"domain": "test",
"type": "nuban",
"currency": "NGN",
"name": "Flesh",
"details": {
"account_number": "olounje",
"account_name": null,
"bank_code": "044",
"bank_name": "Access Bank"
},
"description": "Eater",
"metadata": null,
"recipient_code": "RCP_2x5j67tnnw1t98k",
"active": true,
"id": 28,
"integration": 100073,
"createdAt": "2017-02-02T19:39:04.000Z",
"updatedAt": "2017-02-02T19:39:04.000Z"
},
"domain": "test",
"amount": 4400,
"currency": "NGN",
"source": "balance",
"source_details": null,
"reason": "Eater",
"status": "otp",
"failures": null,
"transfer_code": "TRF_1ptvuv321ahaa7q",
"id": 14,
"createdAt": "2017-02-03T17:21:54.000Z",
"updatedAt": "2017-02-03T17:21:54.000Z"
},
{
"integration": 100073,
"recipient": {
"domain": "test",
"type": "nuban",
"currency": "USD",
"name": "FleshUSD",
"details": {
"account_number": "1111111111",
"account_name": null,
"bank_code": "044",
"bank_name": "Access Bank"
},
"description": "EaterUSD",
"metadata": null,
"recipient_code": "RCP_bi84k5gguakuqmg",
"active": true,
"id": 22,
"integration": 100073,
"createdAt": "2017-01-23T16:52:48.000Z",
"updatedAt": "2017-01-23T16:52:48.000Z"
},
"domain": "test",
"amount": 3300,
"currency": "NGN",
"source": "balance",
"source_details": null,
"reason": "I love you",
"status": "otp",
"failures": null,
"transfer_code": "TRF_5pr8ypzb0htx0cn",
"id": 13,
"createdAt": "2017-01-23T16:55:59.000Z",
"updatedAt": "2017-01-23T16:55:59.000Z"
}
],
"meta": {
"total": 2,
"skipped": 0,
"perPage": 50,
"page": 1,
"pageCount": 1
}
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Initiate Transfer
Send money to your customers
Response
20 object properties
/transfercurl https://api.paystack.co/transfer \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-X POSTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.initiate();
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.initiate()
puts response.data{
"status": true,
"message": "Transfer has been queued",
"data": {
"transfersessionid": [],
"transfertrials": [],
"domain": "test",
"amount": 100000,
"currency": "NGN",
"reference": "acv_9ee55786-2323-4760-98e2-6380c9cb3f68",
"source": "balance",
"source_details": null,
"reason": "Bonus for the week",
"status": "success",
"failures": null,
"transfer_code": "TRF_v5tip3zx8nna9o78",
"titan_code": null,
"transferred_at": null,
"id": 860703114,
"integration": 463433,
"request": 1068439313,
"recipient": 56824902,
"createdAt": "2025-08-04T10:32:40.000Z",
"updatedAt": "2025-08-04T10:32:40.000Z"
}
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Finalize Transfer
Finalize an initiated transfer
Request Body
Response
/transfer/finalize_transfercurl https://api.paystack.co/transfer/finalize_transfer \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"transfer_code": "TRF_vsyqdmlzble3uii",
"otp": "928783"
}' \
-X POSTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.finalize({
transfer_code: "TRF_vsyqdmlzble3uii",
otp: "928783"
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.finalize({
transfer_code: "TRF_vsyqdmlzble3uii",
otp: "928783"
})
puts response.data{
"status": true,
"message": "Transfer has been queued",
"data": {
"domain": "test",
"amount": 1000000,
"currency": "NGN",
"reference": "n7ll9pzl6b",
"source": "balance",
"source_details": null,
"reason": "E go better for you",
"status": "success",
"failures": null,
"transfer_code": "TRF_zuirlnr9qblgfko",
"titan_code": null,
"transferred_at": null,
"id": 529410,
"integration": 123460,
"recipient": 225204,
"createdAt": "2018-08-02T10:02:55.000Z",
"updatedAt": "2018-08-02T10:12:05.000Z"
}
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Initiate Bulk Transfer
Batch multiple transfers in a single request.
You need to disable the Transfers OTP requirement to use this endpoint.
Request Body
Response
/transfer/bulkcurl https://api.paystack.co/transfer/bulk \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"source": "balance",
"transfers": []
}' \
-X POSTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.bulk({
source: "balance",
transfers: []
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.bulk({
source: "balance",
transfers: []
})
puts response.data{
"status": true,
"message": "3 transfers queued.",
"data": [
{
"reference": "acv_2627bbfe-1a2a-4a1a-8d0e-9d2ee6c31496",
"recipient": "RCP_gd9vgag7n5lr5ix",
"amount": 20000,
"transfer_code": "TRF_o0mv5dc2lv4t2wdb",
"currency": "NGN",
"status": "success"
},
{
"reference": "acv_1bd0c1f8-78c2-463b-8bd4-ed9eeb36be50",
"recipient": "RCP_zpk2tgagu6lgb4g",
"amount": 35000,
"transfer_code": "TRF_tlvxomz43gjso2py",
"currency": "NGN",
"status": "success"
},
{
"reference": "acv_11bebfc3-18b3-40aa-a4df-c55068c93457",
"recipient": "RCP_dfznnod8rwxlwgn",
"amount": 15000,
"transfer_code": "TRF_yt2y2gcd3dmli8av",
"currency": "NGN",
"status": "success"
}
]
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Fetch Transfer
Get details of a transfer on your integration
Path Parameters
Response
22 object properties
16 object properties
5 object properties
2 object properties
/transfer/{code}curl https://api.paystack.co/transfer/TRF_1ptvuv321ahaa7q \
-H "Authorization: Bearer YOUR_SECRET_KEY"import { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.fetch("TRF_1ptvuv321ahaa7q");
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.fetch("TRF_1ptvuv321ahaa7q")
puts response.data{
"status": true,
"message": "Transfer retrieved",
"data": {
"amount": 20000,
"createdAt": "2024-02-01T08:32:21.000Z",
"currency": "NGN",
"domain": "test",
"failures": null,
"id": 451930323,
"integration": 463433,
"reason": "Life go better for you",
"reference": "ge-bzrf8u8k2pygxrnqf",
"source": "balance",
"source_details": null,
"status": "success",
"titan_code": null,
"transfer_code": "TRF_fpmd0l8uta8upow7",
"request": 502643104,
"transferred_at": null,
"updatedAt": "2024-02-01T08:34:07.000Z",
"recipient": {
"active": true,
"createdAt": "2021-10-21T11:08:04.000Z",
"currency": "NGN",
"description": null,
"domain": "test",
"email": "[email protected]",
"id": 19643784,
"integration": 463433,
"metadata": {
"custom_fields": [
{
"display_name": "Branch Name",
"variable_name": "branchName",
"value": "funny place, Alabama"
},
{
"display_name": "Branch ID",
"variable_name": "branchID",
"value": "123"
}
]
},
"name": "Abbey Baker",
"recipient_code": "RCP_rjs1szi4ax5hoeo",
"type": "nuban",
"updatedAt": "2023-03-29T08:39:39.000Z",
"is_deleted": false,
"isDeleted": false,
"details": {
"authorization_code": null,
"account_number": "0123456789",
"account_name": "Abbey Baker",
"bank_code": "058",
"bank_name": "Guaranty Trust Bank"
}
},
"session": {
"provider": null,
"id": null
},
"fee_charged": 0,
"fees_breakdown": null,
"gateway_response": null
}
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Verify Transfer
Verify the status of a transfer on your integration
Path Parameters
Response
19 object properties
15 object properties
5 object properties
2 object properties
/transfer/verify/{reference}curl https://api.paystack.co/transfer/verify/acv_9ee55786-2323-4760-98e2-6380c9cb3f67 \
-H "Authorization: Bearer YOUR_SECRET_KEY"import { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.verify("acv_9ee55786-2323-4760-98e2-6380c9cb3f67");
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.verify("acv_9ee55786-2323-4760-98e2-6380c9cb3f67")
puts response.data{
"status": true,
"message": "Transfer retrieved",
"data": {
"amount": 100000,
"createdAt": "2025-08-04T09:59:19.000Z",
"currency": "NGN",
"domain": "test",
"failures": null,
"id": 860670817,
"integration": 463433,
"reason": "Bonus for the week",
"reference": "acv_9ee55786-2323-4760-98e2-6380c9cb3f67",
"source": "balance",
"source_details": null,
"status": "success",
"titan_code": null,
"transfer_code": "TRF_8opchtrhtjlfz90n",
"request": 1068403325,
"transferred_at": null,
"updatedAt": "2025-08-04T09:59:19.000Z",
"recipient": {
"active": true,
"createdAt": "2023-07-11T15:42:27.000Z",
"currency": "NGN",
"description": "",
"domain": "test",
"email": null,
"id": 56824902,
"integration": 463433,
"metadata": null,
"name": "Jekanmo Padie",
"recipient_code": "RCP_gd9vgag7n5lr5ix",
"type": "nuban",
"updatedAt": "2023-07-11T15:42:27.000Z",
"is_deleted": false,
"isDeleted": false,
"details": {
"authorization_code": null,
"account_number": "9876543210",
"account_name": null,
"bank_code": "044",
"bank_name": "Access Bank"
}
},
"session": {
"provider": null,
"id": null
},
"fee_charged": 1000,
"fees_breakdown": null,
"gateway_response": null
}
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}{
"status": false,
"message": "Transfer not found"
}Copy link Export Transfers
Export a list of transfers carried out on your integration
Query Parameters
Response
/transfer/exportcurl https://api.paystack.co/transfer/export \
-H "Authorization: Bearer YOUR_SECRET_KEY"import { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.exportTransfer({
recipient: "RECIPIENT",
status: "success"
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.export_transfer({
recipient: "RECIPIENT",
status: "success"
})
puts response.data{
"status": true,
"message": "Request successful",
"data": {}
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Resend OTP for Transfer
Generates and send a new OTP to customer in the event they are having trouble receiving one.
Request Body
Response
/transfer/resend_otpcurl https://api.paystack.co/transfer/resend_otp \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"transfer_code": "TRF_vsyqdmlzble3uii",
"reason": "disable_otp"
}' \
-X POSTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.resendOtp({
transfer_code: "TRF_vsyqdmlzble3uii",
reason: "disable_otp"
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.resend_otp({
transfer_code: "TRF_vsyqdmlzble3uii",
reason: "disable_otp"
})
puts response.data{
"status": true,
"message": "OTP has been resent"
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Disable OTP for Transfers
This is used in the event that you want to be able to complete transfers programmatically without use of OTPs. No arguments required. You will get an OTP to complete the request.
Response
/transfer/disable_otpcurl https://api.paystack.co/transfer/disable_otp \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-X POSTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.disableOtp();
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.disable_otp()
puts response.data{
"status": true,
"message": "OTP has been sent to mobile number ending with 4321"
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Finalize Disabling OTP for Transfers
Finalize the request to disable OTP on your transfers
Request Body
Response
/transfer/disable_otp_finalizecurl https://api.paystack.co/transfer/disable_otp_finalize \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"otp": "928783"
}' \
-X POSTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.disableOtpFinalize({
otp: "928783"
});
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.disable_otp_finalize({
otp: "928783"
})
puts response.data{
"status": true,
"message": "OTP requirement for transfers has been disabled"
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}Copy link Enable OTP requirement for Transfers
In the event that a customer wants to stop being able to complete transfers programmatically, this endpoint helps turn OTP requirement back on. No arguments required.
Response
/transfer/enable_otpcurl https://api.paystack.co/transfer/enable_otp \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-X POSTimport { Paystack } from "@paystack/paystack-sdk";
const paystack = new Paystack({ secretKey: process.env.PAYSTACK_SECRET_KEY! });
const response = await paystack.transfer.enableOtp();
console.log(response.data);require "paystack"
paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
response = paystack.transfer.enable_otp()
puts response.data{
"status": true,
"message": "OTP requirement for transfers has been enabled"
}{
"status": false,
"message": "An error occurred",
"meta": {
"nextStep": "string"
},
"type": "string",
"code": "validation_error",
"errorCodeMappingNotFound": true
}