Payments
Pay with Transfer
In a nutshell
Reference information for temporary bank transfer payments on Paystack.
Pay with Transfer is Paystack’s temporary bank transfer flow. For each transaction, Paystack creates a dynamic virtual account number that is tied to the current charge. The customer sends money to that account, and the transfer is matched back to the transaction.
Copy linkHow it works
A transfer charge is created with the customer email, amount, and a bank_transfer object. The response includes an account number generated specifically for that transaction. The account becomes invalid after the transaction completes or after its expiry window lapses.
This channel is different from Dedicated Virtual Accounts:
- Pay with Transfer creates a temporary account for a single transaction.
- Dedicated Virtual Accounts assign a reusable account to a customer.
Copy linkSupported market
Pay with Transfer is available to businesses in Nigeria and Ghana.
Copy linkExpiry rules
The account_expires_at value controls the validity period for the temporary account.
| Rule | Value |
|---|---|
| Minimum validity | 15 minutes from current time |
| Maximum validity | 8 hours from current time |
null value | Paystack defaults to 8 hours |
If the requested expiry is less than 15 minutes away, Paystack defaults to 15 minutes. If it exceeds 8 hours, Paystack defaults to 8 hours.
Copy linkConfirmation timing
Bank transfer confirmation is asynchronous because the payment originates from the customer’s bank. Paystack confirms completion primarily through webhook events.
| Event | Meaning |
|---|---|
charge.success | The customer transfer was successful |
bank.transfer.rejected | The customer sent a wrong amount or the transfer was rejected by fraud checks |
Paystack also provides a pending-charge check for manual status lookup when webhook confirmation has not yet arrived.
Copy linkOperational notes
Transfer accounts are transaction-scoped and should be treated as short-lived payment instructions. Businesses that need reusable account details, customer-level assignment, or tighter control over inbound transfers typically use Dedicated Virtual Accounts instead.