Sign in

Payments

How to charge via bank transfer

View as Markdown

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.success when the transfer succeeds
  • bank.transfer.rejected when 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.

Was this page helpful?