Cancel pre-purchase transaction

POST

/api/merchant-portal/merchant-access/online-transaction/pre-auth-cancellation

Cancel pre-auth (or cancel pre-authorization) is the process of releasing a temporary hold on funds placed on a customer's payment method before the final transaction is completed.

Important Notes:

You can only cancel a pre-authorization if the transaction is still pending; if the pre-auth has already been completed or previously cancelled, it cannot be cancelled again.

Each transaction’s pre-authorization can be cancelled only once.

Once the cancellation is successfully processed, the transaction status will update to "CANCELLED."

For ABA PAY and Card transactions, funds are instantly released back to the payer, whereas for KHQR transactions, the funds will be refunded to the payer.

Request

Header Params

Body Params application/json

Example

{
    "request_time": "20200728093403",
    "merchant_id": "ec000002",
    "merchant_auth": "b1453eac8cd686f...c026a3f70678afd",
    "hash": "wR2bVPV...Q6/llsnJ bw=="
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://checkout-sandbox.payway.com.kh//api/merchant-portal/merchant-access/online-transaction/pre-auth-cancellation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_time": "20200728093403",
    "merchant_id": "ec000002",
    "merchant_auth": "b1453eac8cd686f...c026a3f70678afd",
    "hash": "wR2bVPV...Q6/llsnJ bw=="
}'

Responses

🟢200OK

application/json

Body

Examples

SuccessException

{
    "grand_total": 1.5,
    "currency": "USD",
    "transaction_status": "CANCELLED",
    "status": {
        "code": "00",
        "message": "Success"
    }
}

Complete pre-auh transaction with payout

Payout