Skip to main content
Server path: /paystack-transfers | Type: Application | PCID required: Yes

Tools

ToolDescription
paystack_transfers_apple_pay_list_domainList Domains
paystack_transfers_apple_pay_register_domainRegister Domain
paystack_transfers_apple_pay_unregister_domainUnregister Domain
paystack_transfers_balance_fetchFetch Balance
paystack_transfers_balance_ledgerBalance Ledger
paystack_transfers_bank_listList Banks
paystack_transfers_bank_resolve_account_numberResolve Account Number
paystack_transfers_bank_validate_account_numberValidate Bank Account
paystack_transfers_bulk_charge_chargesList Charges in a Batch
paystack_transfers_bulk_charge_fetchFetch Bulk Charge Batch
paystack_transfers_bulk_charge_initiateInitiate Bulk Charge
paystack_transfers_bulk_charge_listList Bulk Charge Batches
paystack_transfers_bulk_charge_pausePause Bulk Charge Batch
paystack_transfers_bulk_charge_resumeResume Bulk Charge Batch
paystack_transfers_integration_fetch_payment_session_timeoutFetch Payment Session Timeout
paystack_transfers_integration_update_payment_session_timeoutUpdate Payment Session Timeout
paystack_transfers_miscellaneous_avsList States (AVS)
paystack_transfers_miscellaneous_list_countriesList Countries
paystack_transfers_miscellaneous_resolve_card_binResolve Card BIN
paystack_transfers_settlements_fetchList Settlements
paystack_transfers_settlements_transactionFetch Settlement Transactions
paystack_transfers_split_add_subaccountAdd Subaccount to Split
paystack_transfers_split_createCreate Split
paystack_transfers_split_fetchFetch Split
paystack_transfers_split_listList Splits
paystack_transfers_split_remove_subaccountRemove Subaccount from split
paystack_transfers_split_updateUpdate Split
paystack_transfers_transfer_bulkInitiate Bulk Transfer
paystack_transfers_transfer_disable_otpDisable OTP for Transfers
paystack_transfers_transfer_disable_otp_finalizeFinalize Disabling OTP for Transfers
paystack_transfers_transfer_enable_otpEnable OTP requirement for Transfers
paystack_transfers_transfer_export_transferExport Transfers
paystack_transfers_transfer_fetchFetch Transfer
paystack_transfers_transfer_finalizeFinalize Transfer
paystack_transfers_transfer_initiateInitiate Transfer
paystack_transfers_transfer_listList Transfers
paystack_transfers_transfer_resend_otpResend OTP for Transfer
paystack_transfers_transfer_verifyVerify Transfer
paystack_transfers_transferrecipient_bulkBulk Create Transfer Recipient
paystack_transfers_transferrecipient_createCreate Transfer Recipient
paystack_transfers_transferrecipient_deleteDelete Transfer Recipient
paystack_transfers_transferrecipient_fetchFetch Transfer recipient
paystack_transfers_transferrecipient_listList Transfer Recipients
paystack_transfers_transferrecipient_updateUpdate Transfer Recipient

paystack_transfers_apple_pay_list_domain

List Domains Parameters:
ParameterTypeRequiredDefaultDescription
use_cursorbooleanNoA flag to indicate if cursor based pagination should be used
nextstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the next set of data
previousstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the previous set of data

paystack_transfers_apple_pay_register_domain

Register Domain Parameters:
ParameterTypeRequiredDefaultDescription
domainNamestringYesThe domain or subdomain for your application

paystack_transfers_apple_pay_unregister_domain

Unregister Domain Parameters:
ParameterTypeRequiredDefaultDescription
domainNamestringYesThe domain or subdomain for your application

paystack_transfers_balance_fetch

Fetch Balance

paystack_transfers_balance_ledger

Balance Ledger Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoNumber of records to fetch per page
pageintegerNoThe section to retrieve
fromstringNoThe start date
tostringNoThe end date

paystack_transfers_bank_list

List Banks Parameters:
ParameterTypeRequiredDefaultDescription
countrystringNoThe country from which to obtain the list of supported banks
currencystringNoThe country from which to obtain the list of supported banks
use_cursorbooleanNoA flag to indicate if cursor based pagination should be used
perPageintegerNoThe number of records to fetch per request
pageintegerNoThe offset to retrieve data from
nextstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the next set of data
previousstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the previous set of data
pay_with_bank_transferbooleanNoA flag to filter for available banks a customer can make a transfer to complete a payment
pay_with_bankbooleanNoA flag to filter for banks a customer can pay directly from
enabled_for_verificationbooleanNoA flag to filter the banks that are supported for account verification in South Africa. You need to combine this with either the currency or country filter.
gatewaystringNoThe type of gateway for a Nigerian bank
typestringNoType of financial channel
include_nip_sort_codebooleanNoA flag that returns Nigerian banks with their NIP institution code. The returned value can be used in identifying institutions on NIP.

paystack_transfers_bank_resolve_account_number

Resolve Account Number Parameters:
ParameterTypeRequiredDefaultDescription
account_numberintegerNoThe account number of interest
bank_codeintegerNoThe bank code associated with the account number

paystack_transfers_bank_validate_account_number

Validate Bank Account Parameters:
ParameterTypeRequiredDefaultDescription
account_namestringYesCustomer’s first and last name registered with their bank
account_numberstringYesCustomer’s account number
account_typestringYesThe type of the customer’s account number
bank_codestringYesThe bank code of the customer’s bank. You can fetch the bank codes by using our List Banks endpoint
country_codestringYesThe two digit ISO code of the customer’s bank
document_numberstringNoCustomer’s mode of identity number
document_typestringYesCustomer’s mode of identity

paystack_transfers_bulk_charge_charges

List Charges in a Batch Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesAn code for the batch whose charges you want to retrieve
perPageintegerNoNumber of records to fetch per page
pageintegerNoThe offset to retrieve data from
statusstringNoFilter by the status of the charges

paystack_transfers_bulk_charge_fetch

Fetch Bulk Charge Batch Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesThe code for the charge whose batches you want to retrieve

paystack_transfers_bulk_charge_initiate

Initiate Bulk Charge Parameters:
ParameterTypeRequiredDefaultDescription
bodyobject[]NoRequest body

paystack_transfers_bulk_charge_list

List Bulk Charge Batches Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoNumber of records to fetch per page
pageintegerNoThe offset to retrieve data from
statusstringNoFilter by the status of the charges

paystack_transfers_bulk_charge_pause

Pause Bulk Charge Batch Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesThe batch code for the bulk charge you want to pause

paystack_transfers_bulk_charge_resume

Resume Bulk Charge Batch Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesThe batch code for the bulk charge you want to pause

paystack_transfers_integration_fetch_payment_session_timeout

Fetch Payment Session Timeout

paystack_transfers_integration_update_payment_session_timeout

Update Payment Session Timeout Parameters:
ParameterTypeRequiredDefaultDescription
timeoutintegerYesTime in seconds before a transaction becomes invalid

paystack_transfers_miscellaneous_avs

List States (AVS) Parameters:
ParameterTypeRequiredDefaultDescription
countrystringNoThe country code of the states to list. It is gotten after the charge request

paystack_transfers_miscellaneous_list_countries

List Countries

paystack_transfers_miscellaneous_resolve_card_bin

Resolve Card BIN Parameters:
ParameterTypeRequiredDefaultDescription
binintegerYesThe card bank identification number

paystack_transfers_settlements_fetch

List Settlements Parameters:
ParameterTypeRequiredDefaultDescription
perPageintegerNoThe number of records to fetch per request
pageintegerNoThe offset to retrieve data from

paystack_transfers_settlements_transaction

Fetch Settlement Transactions Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe settlement ID in which you want to fetch its transactions

paystack_transfers_split_add_subaccount

Add Subaccount to Split Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the split configuration to fetch
shareintegerNoThe percentage or flat quota of the customer or partner
subaccountstringNoSubaccount code of the customer or partner

paystack_transfers_split_create

Create Split Parameters:
ParameterTypeRequiredDefaultDescription
bearer_subaccountstringNoThis is the subaccount code of the customer or partner that would bear the transaction charge if you specified subaccount as the bearer type
bearer_typestringNoThis allows you specify how the transaction charge should be processed
currencystringYesThe transaction currency
namestringYesName of the transaction split
subaccountsobject[]YesA list of object containing subaccount code and number of shares
typestringYesThe type of transaction split you want to create.

paystack_transfers_split_fetch

Fetch Split Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the split configuration to fetch

paystack_transfers_split_list

List Splits Parameters:
ParameterTypeRequiredDefaultDescription
subaccount_codestringNoFilter by subaccount code
namestringNoThe name of the split
activebooleanNoThe status of the split
per_pageintegerNoThe number of records to fetch per request
pageintegerNoThe offset to retrieve data from
fromstringNoThe start date
tostringNoThe end date

paystack_transfers_split_remove_subaccount

Remove Subaccount from split Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the split configuration to fetch
shareintegerNoThe percentage or flat quota of the customer or partner
subaccountstringNoSubaccount code of the customer or partner

paystack_transfers_split_update

Update Split Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe id value
activebooleanNoToggle status of split. When true, the split is active, else it’s inactive
bearer_subaccountstringNoThis is the subaccount code of the customer or partner that would bear the transaction charge if you specified subaccount as the bearer type
bearer_typestringNoThis allows you specify how the transaction charge should be processed
namestringNoName of the transaction split

paystack_transfers_transfer_bulk

Initiate Bulk Transfer Parameters:
ParameterTypeRequiredDefaultDescription
currencystringNoSpecify the currency of the transfer.
sourcestringYesThe source of funds for the transfer.
transfersobject[]YesA list of transfer object

paystack_transfers_transfer_disable_otp

Disable OTP for Transfers

paystack_transfers_transfer_disable_otp_finalize

Finalize Disabling OTP for Transfers Parameters:
ParameterTypeRequiredDefaultDescription
otpstringYesOTP sent to business phone to verify disabling OTP requirement

paystack_transfers_transfer_enable_otp

Enable OTP requirement for Transfers

paystack_transfers_transfer_export_transfer

Export Transfers Parameters:
ParameterTypeRequiredDefaultDescription
recipientstringNoExport transfer by the recipient code
statusstringNoExport transfer by status
fromstringNoThe start date
tostringNoThe end date

paystack_transfers_transfer_fetch

Fetch Transfer Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesTransfer code

paystack_transfers_transfer_finalize

Finalize Transfer Parameters:
ParameterTypeRequiredDefaultDescription
otpstringYesOTP sent to business phone to verify transfer
transfer_codestringYesThe transfer code you want to finalize

paystack_transfers_transfer_initiate

Initiate Transfer Parameters:
ParameterTypeRequiredDefaultDescription
amountintegerYesAmount to transfer in kobo if currency is NGN and pesewas if currency is GHS.
currencystringNoSpecify the currency of the transfer.
reasonstringNoThe reason or narration for the transfer.
recipientstringYesThe transfer recipient’s code
referencestringYesTo ensure idempotency, you need to provide e a unique identifier for the request. The identifier should be a lowercase alphanumeric string with only -,_ symbols allowed.
sourcestringYesThe source of funds to send from

paystack_transfers_transfer_list

List Transfers Parameters:
ParameterTypeRequiredDefaultDescription
use_cursorbooleanNoA flag to indicate if cursor based pagination should be used
nextstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the next set of data
previousstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the previous set of data
per_pageintegerNoThe number of records to fetch per request
pageintegerNoThe offset to retrieve data from
fromstringNoThe start date
tostringNoThe end date
recipientstringNoFilter transfer by the recipient code
statusstringNoFilter transfer by status

paystack_transfers_transfer_resend_otp

Resend OTP for Transfer Parameters:
ParameterTypeRequiredDefaultDescription
reasonstringYesSpecify the flag to indicate the purpose of the OTP
transfer_codestringYesThe transfer code that requires an OTP validation

paystack_transfers_transfer_verify

Verify Transfer Parameters:
ParameterTypeRequiredDefaultDescription
referencestringYesTransfer reference

paystack_transfers_transferrecipient_bulk

Bulk Create Transfer Recipient Parameters:
ParameterTypeRequiredDefaultDescription
batchobject[]YesA list of transfer recipient object.

paystack_transfers_transferrecipient_create

Create Transfer Recipient Parameters:
ParameterTypeRequiredDefaultDescription
account_numberstringYesRecipient’s bank account number
authorization_codestringNoAn authorization code from a previous transaction
bank_codestringYesRecipient’s bank code. You can get the list of Bank Codes by calling the List Banks endpoint
currencystringNoCurrency for the account receiving the transfer
descriptionstringNoA description for this recipient
metadataobjectNoJSON object of custom data
namestringYesThe recipient’s name according to their account registration.
typestringYesRecipient Type

paystack_transfers_transferrecipient_delete

Delete Transfer Recipient Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesTransfer recipient code

paystack_transfers_transferrecipient_fetch

Fetch Transfer recipient Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesTransfer recipient code

paystack_transfers_transferrecipient_list

List Transfer Recipients Parameters:
ParameterTypeRequiredDefaultDescription
use_cursorbooleanNoA flag to indicate if cursor based pagination should be used
nextstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the next set of data
previousstringNoAn alphanumeric value returned for every cursor based retrieval, used to retrieve the previous set of data
per_pageintegerNoThe number of records to fetch per request
pageintegerNoThe offset to retrieve data from

paystack_transfers_transferrecipient_update

Update Transfer Recipient Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesTransfer recipient code
emailstringNoRecipient’s email address
namestringNoRecipient’s name