Payments
How to charge via bank transfer
In a nutshell
Create a temporary transfer account with the Charge API and confirm completion from webhook or polling.
For the integration model behind this flow, see Charge API.
Copy linkCreate the transfer charge
Send the email, amount, and bank_transfer object to https://api.paystack.co/charge.
curl https://api.paystack.co/charge \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"amount": "10000",
"bank_transfer": {
"account_expires_at": "2025-04-24T16:40:57.954Z"
}
}' \
-X POST
account_expires_at is optional. It uses ISO 8601 format. Paystack enforces a minimum of 15 minutes and a maximum of 8 hours for the temporary account.
Copy linkShow the transfer instructions
The response includes the account details the customer should fund:
{
"status": true,
"message": "Charge attempted",
"data": {
"reference": "kcvu0t3kzs",
"status": "pending_bank_transfer",
"display_text": "Please make a transfer to the account specified",
"account_name": "TEST-MANAGED-ACCOUNT",
"account_number": "1260257501",
"bank": {
"name": "Test Bank"
},
"account_expires_at": "2025-04-24T16:40:57.954Z"
}
}
Store the reference and show the account_name, account_number, bank name, and expiry time to the customer.
Copy linkConfirm completion
Use webhooks to confirm the outcome:
charge.successwhen the transfer succeedsbank.transfer.rejectedwhen the customer sends the wrong amount or the transfer is rejected
If you do not get a webhook yet, poll the transaction status from your server. Paystackβs payment channel guide recommends the pending charge or verify flow for manual confirmation.
curl https://api.paystack.co/transaction/verify/:reference \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-X GET
Treat the payment as complete only after you receive a successful final status for that reference.