Request cancellation of a payment order

​

Records a cancellation request against a Standard payment order. Instant payment orders are not cancelable. For Standard orders, only AWAITING_FUNDS and FUNDED are cancelable — any later status returns 409. The endpoint returns 202 after recording the request: the actual CANCELED transition is deferred until every in-flight inbound transfer resolves (verification + custody sweep), so clients should poll the order to observe the final state.

Path Parameters
  • paymentOrderId
    Type: string Format: uuid
    required
Body
required
application/json
  • reason
    Type: string
    min length:  
    1
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/v1/payment-orders/{paymentOrderId}/cancel
curl https://api.bettermoney.com/api/v1/payment-orders/123e4567-e89b-12d3-a456-426614174000/cancel \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "reason": ""
}'

{
  "paymentOrderId": "string",
  "status": "AWAITING_FUNDS",
  "cancelRequestedAt": "2026-09-08T20:57:50.014Z"
}

Default Response