Cancel Order ​

Cancel a payment order that has not yet been paid. This endpoint uses header-based HMAC signing.

Endpoint ​

POST /v4.0.0/pay/orders/cancel/api

Request Body ​

Request Headers ​

See Authentication for the required HMAC signing headers:

• hashnut-request-uuid
• hashnut-request-timestamp
• hashnut-request-sign

Example Request ​

{
  "accessKeyId": "ak_test_abc123",
  "payOrderId": "PO202606210001",
  "merchantOrderId": "ORDER-20260621-001"
}

Example Response ​

{
  "code": 0,
  "msg": "success",
  "data": {
    "payOrderId": "PO202606210001",
    "state": -3
  }
}

Cancellation Rules ​

• Only orders in the INIT (0) state can be canceled.
• Orders that have already received a payment (PAID, CONFIRMING, SUCCESS, etc.) cannot be canceled.
• Canceled orders transition to the CANCELED (-3) state.
• Cancellation is irreversible.

Error Codes ​