Webhooks

When the user completes a transaction, we will send you a notification regarding the status changes to your specified callback URL.

The format of the callback will be identical to the response you receive when creating the transaction through our API.

Example webhook payload

{
        "responseCode": 200,
        "responseMessage": "success",
        "responseData": {
            "id": "66e934f6-f5d6-4f1c-bb3d-450ec2873782",
            "merchantRef": "REFF012",
            "status": "success",
            "feePayer": "customer",
            "amount": 10000,
            "fee": 4000,
            "totalAmount": 14000,
            "expiredDate": "2025-03-23T10:24:58+07:00",
            "additionalInfo": {
                "callback": "http://your-site-callback.com/notify"
            },
            "virtualAccount": {
                "bankCode": "014",
                "vaNumber": "666555440021",
                "viewName": "Merchant Name"
            }
        }
    }

In the example above, a transaction was update to success

See all status types

Response Status

You can view the ResponseData.Status and adjust it according to our documentation to avoid errors in your webhook handling.

Name
success
Description
The transaction has been successfully paid or successfully processed.
Name
pending
Description
The transaction has not been paid or has not been processed.
Name
expired
Description
The transaction has expired.
Name
failed
Description
The transaction is not processed or has failed.