Skip to main content
A payment is held when it can’t simply be credited, so you decide. The commonest case is a dynamic account receiving the wrong amount, a second payment, or a payment after it expired. You’ll receive va.payment.held or dva.payment.held, and the payment shows with status: held in GET /v1/virtual-accounts/{accountId}/payments and GET /v1/payments/{paymentId}.

Decide

  • Accept it: POST /v1/payments/{paymentId}/accept. It’s credited, less the account’s charge, and you receive ….payment.accepted.
  • Return it: returning money to the sender stays with the bank. Contact your bank; you’ll receive ….payment.returned when it’s done.
A payment that isn’t held answers 409 (code 89); another business’s, 404 (code 88).