Rejections & Returns Coming Soon

Early preview

International payments are coming soon. This preview gives you an early look at the expected experience so you can begin planning your integration.

Rejection Reasons

International payments may be rejected at any stage. When a payment is rejected, the payment.rejected webhook event fires and reason is populated on the payment resource.

Reason	Description
InsufficientFunds	Ledger debit failed at creation — source account balance too low.
QuoteExpired	The quote was not used before its expiry time.
QuoteAlreadyUsed	The quote had already been consumed by another payment.
QuoteAccountMismatch	The account on the payment does not match the quote.
AccountClosed	The source account was closed.
AccountFrozen	The source account was frozen.
DacaIsActive	A DACA (Deposit Account Control Agreement) is active on the source account.
Other	Any other reason; a descriptive string is provided in the reason field.

Return Reasons

International payments may also be returned by the counterparty's bank after they've already been sent. When this happens, the payment moves to Returned status, the payment.returned webhook event fires, and one of the reasons below is populated on reason.

Reason	Description
CounterpartyAccountClosed	The counterparty's account was closed after the payment was sent.
InvalidCounterpartyAccount	The counterparty's account number is invalid or does not exist.
CounterpartyAccountFrozen	The counterparty's account is frozen or blocked.
IncorrectCounterpartyDetails	The counterparty's name or other details on the payment don't match the account on file.
CounterpartyBankRejected	The counterparty's bank rejected the payment.
CounterpartyComplianceHold	The counterparty's bank returned the payment due to a compliance check.
DuplicatePayment	The payment was identified as a duplicate.
Other	Any other reason; a descriptive string is provided in the reason field.