Create
Initiates a cardless withdrawal, debits the account, and returns an OTP for ATM cash collection. Only fixed denominations (multiples of 50,000) are accepted. The target account is specified in the request body (account_id), not in the URL path. This endpoint is rate-limited. See Response Code for SP000–SP020 definitions and merchant actions. CRITICAL: This is a money-out operation requiring X-Signature and X-Timestamp authentication.
Authorizations
Headers
HMAC-SHA512 hex signature, computed as HMAC_SHA512(clientSecret, "{HTTP_METHOD}:{REQUEST_URI}:{ACCESS_TOKEN}:{SHA256_HEX(MINIFIED_BODY)}:{X_TIMESTAMP}"). MINIFIED_BODY is the request body with object keys recursively sorted alphabetically and re-serialised with no whitespace. ACCESS_TOKEN is the bearer token without the Bearer prefix. Missing header returns 422 (response_code=SP018); signature mismatch returns 401 (response_code=SP016).
Body
Target account, reference number, customer details, withdrawal amount, and payment channel selection.
Request body for initiating a new cardless withdrawal transaction. The target account is specified in the body (account_id), not in the URL path.
Response
SP000 Successfully — withdrawal initiated (data.transaction_status.code is 01). The data.otp_number holds the OTP for ATM redemption. Note: data.balance_after is always "0" on this response — it is not the actual post-debit balance; use the show or list endpoint to read the real account balance.
Custom v2 envelope for cardless withdrawal create and cancel. Success uses SP000 (HTTP 200).
