Cancel
Cancels an open withdrawal and restores the debited amount to the account balance. Only withdrawals currently in open status can be canceled. The target account and transaction reference are specified in the request body, not in the URL path. See Response Code for SP000–SP020 definitions and merchant actions.
Authorizations
JWT issued by POST /api/v1.1/access-token/b2b. Send Authorization: Bearer <token>.
Merchant API key (Credential.api_key). Required on every request.
Body
Account, merchant reference number of the withdrawal to cancel, and cancellation reason.
Request body for canceling an open cardless withdrawal transaction.
Unique identifier (ULID) of the merchant account. Must be active and belong to the authenticated merchant.
99"01K946KF851RK7FX075GJHBVKF"
Merchant reference of the withdrawal to cancel. Lookup is scoped to the account and only matches a transaction currently in open status.
64"REF-20260610-001"
Reason for canceling the withdrawal.
100"Customer requested cancellation"
Response
SP000 Successfully — withdrawal canceled (data.transaction_status.code is 05) and the debited amount restored to the account balance. Note: data.expired_at is reused on this response to carry the cancellation timestamp, not an OTP expiry.
Custom v2 envelope for cardless withdrawal create and cancel. Success uses SP000 (HTTP 200).
