ZEzerohash
Payins

Cancel a pending manual approval

Cancels a pending or approved manual approval for a Tier 4 payin transaction, setting it to REJECTED state.

Use this endpoint when a platform or shopper wants to withdraw a transaction that is awaiting compliance review. Once cancelled, the transaction cannot be reinstated — a new POST /pay/rfq must be issued.

The merchant_code query parameter is optional. When omitted, the authenticated platform code is used as the merchant identifier.

delete/pay/{id}/approval

Request

  • Base URL
    https://api.cert.zerohash.com
  • URL
    https://api.cert.zerohash.com/pay/{id}/approval
  • Auth
    API key in header X-SCX-API-KEY and API key in header X-SCX-PASSPHRASE

Path parameters

idstring required

Transaction id of the manual approval to cancel.

Query parameters

participant_codestring required

End-user participant (shopper) code whose approval to cancel.

merchant_codestring

Merchant participant code associated with the approval. Defaults to the authenticated platform code when omitted.

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Response

Approval successfully cancelled.

Changes

No recorded changes to this operation across all 2 revisions of this API.