Bank transfer details object

Last updated: 2026-07-17

PaymentOrder.bankTransferDetails describes generated account availability for a bank-transfer payment.

Field	JSON type	Presence	Merchant meaning
generationStatus	string	Always	pending, processing, succeeded, failed_retryable, or failed_manual_review
accountName	string	Conditional	Generated account name when generation succeeded
accountNumber	string	Conditional	Generated account number when generation succeeded
expiresAt	string (date-time) or null	Optional	Account expiry when supplied
bankName	string	Optional	Generated account bank name
failureReason	string	Conditional	Public failure reason for a failed state
retryAfter	string (date-time) or null	Optional	Earliest suggested retry or poll time
updatedAt	string (date-time)	Always	Last generation-state update

Display account details only when generationStatus is succeeded. For pending or processing, wait until retryAfter when it is present and read the payment again. A generated account is a payment instruction, not proof that the customer has completed the transfer.

Related guide: Bank transfer.