Invalidate Order

Invalidate Order for Checkout with ShopeePay

Use this endpoint to invalidate the existing order using payment reference id for Checkout with ShopeePay if the order in the merchant’s system is closed/cancelled. Once the order payment reference id is invalidated successfully, the corresponding redirect_url_http can no longer be used to make payment.

  • URL: "/v3/merchant-host/order/invalidate"

Request Parameters

FieldTypeMandatoryDescription
request_idstringYUnique identifier for request, accepts up to 64 characters.
payment_reference_idstringYPayment reference ID that corresponds to the order being invalidated.
merchant_ext_idstringYUnique identifier of merchant in merchant’s system.
store_ext_idstringYUnique identifier of store in merchant’s system.

Sample API Request

REQUEST

{
"request_id": "input-unique-request-id-here",
"payment_reference_id": "order-to-be-invalidated",
"merchant_ext_id": "external-merchant",
"store_ext_id": "external-store"
}
arrow-svg

Copy

Response Parameters

FieldTypeDescription
request_idstringUnique identifier for request.
errcodeint32Error code to specify the error returned.
debug_msgstringDebug message to provide more information.

Sample API Response

RESPONSE

{
"request_id": "input-unique-request-id-here",
"errcode": 0,
"debug_msg": "success"
}
arrow-svg

Copy

Response Code

ValueDescription
-2A server dropped the connection
-1A server error occurred
0Success
1The request parameters is invalid or a mandatory parameter is empty
2Permission denied, often due to invalid status
4Not found, often due to merchant/store/user/transaction not found
1800A server error occurred
1901QR code cannot be invalidated