# Webhook

After receiving a notification, please process according to `notify_type`; and due to the asynchronous nature of notifications, it is recommended to use API query results as the source of truth

## Payment Notifications

### Authorization Success Notification

When a transaction order is successfully authorized, an authorization success notification will be triggered. The field `notify_type` represents the notification type, and `status` only represents the order status at the time of notification.


```json
{
  "notify_type": "PAYMENT.AUTHORIZATION",
  "merchant_id": "18356675194960",
  "trans_id": "m58129512",
  "order_id": "GW2056xxxxx2136685",
  "status": "AUTHORIZED",
  "amount": 199,
  "currency": "EUR",
  "session_id": "CS20602223728587",
  "shopper_reference": "f4911bc8b17106a08f2f7a89a9fc4d11",
  "expire_time": "2025-03-08T10:00:00+08:00",
  "payment": {
    "payment_method": "BANKCARD"
  },
  "card_info": {
    "bin": "424242",
    "last4": "4242",
    "card_brand": "VISA"
  }
}
```

### Capture Success Notification

When a transaction order is successful, a capture success notification will be triggered. The field `notify_type` represents the notification type, and `status` only represents the order status at the time of notification.


```json
{
  "notify_type": "PAYMENT.SUCCESS",
  "error_code": "0000",
  "error_description": "request success",
  "merchant_id": "18356675194960",
  "trans_id": "m58129512",
  "order_id": "GW2056xxxxx2136685",
  "session_id": "CS20602223728587",
  "status": "SUCCESS",
  "amount": 99,
  "currency": "USD",
  "pay_finish_time": "2025-03-08T10:00:00+08:00",
  "recurring_agreement_id": "RA2061xxxx0784537",
  "token": "TK206139xxx264751",
  "shopper_reference": "f4911bc8b17106a08f2f7a89a9fc4d11",
  "expire_time": "2025-03-08T10:00:00+08:00",
  "payment": {
    "payment_method": "BANKCARD"
  },
  "card_info": {
    "bin": "424242",
    "last4": "4242",
    "card_brand": "VISA"
  },
  "balances": {
    "authed_amount": 0,
    "captured_amount": 0,
    "able_to_capture_amount": 0,
    "voided_amount": 0,
    "able_to_void_amount": 0,
    "refunded_amount": 0,
    "able_to_refund_amount": 0
  }
}
```

### Capture Failure Notification

When a transaction order fails, a capture failure notification will be triggered. The field `notify_type` represents the notification type, and `status` only represents the order status at the time of notification.


```json
{
  "notify_type": "PAYMENT.FAILURE",
  "error_code": "0068",
  "error_description": "The transaction was declined by your issuer bank",
  "merchant_id": "18356675194960",
  "trans_id": "m58129512",
  "order_id": "GW20620784537",
  "status": "FAILURE",
  "amount": 1979,
  "currency": "USD",
  "pay_finish_time": "2025-04-23T16:43:11+08:00",
  "recurring_agreement_id": "RA2061xxxx0784537",
  "token": "TK206139xxx264751",
  "shopper_reference": "f4911bc8b17106a08f2f7a89a9fc4d11",
  "expire_time": "2025-04-30T22:43:09+08:00",
  "payment": {
    "payment_method": "BANKCARD"
  },
  "card_info": {
    "bin": "400000",
    "last4": "9987",
    "card_brand": "VISA"
  },
  "balances": {
    "authed_amount": 0,
    "captured_amount": 0,
    "able_to_capture_amount": 0,
    "voided_amount": 0,
    "able_to_void_amount": 0,
    "refunded_amount": 0,
    "able_to_refund_amount": 0
  }
}
```

### Payment Cancellation Notification

When a transaction order is cancelled, a payment cancellation notification will be triggered. The field `notify_type` represents the notification type, and `status` only represents the order status at the time of notification.


```json
{
  "notify_type": "PAYMENT.CANCELED",
  "error_code": "0000",
  "error_description": "request success",
  "merchant_id": "18356675194960",
  "trans_id": "m58129512",
  "order_id": "GW20620784537",
  "status": "CANCELED",
  "amount": 2903,
  "currency": "EUR",
  "pay_finish_time": "2025-04-17T19:59:24+08:00",
  "shopper_reference": "f4911bc8b17106a08f2f7a89a9fc4d11",
  "expire_time": "2025-04-18T01:59:21+08:00",
  "payment": {
    "payment_method": "BANKCARD"
  },
  "card_info": {
    "bin": "424242",
    "last4": "4242",
    "card_brand": "VISA"
  },
  "balances": {
    "authed_amount": 2903,
    "captured_amount": 0,
    "able_to_capture_amount": 0,
    "voided_amount": 2903,
    "able_to_void_amount": 0,
    "refunded_amount": 0,
    "able_to_refund_amount": 0
  }
}
```

## Refund Notifications

### Refund Success Notification

When a transaction order refund is successful, a refund success notification will be triggered. The field `notify_type` represents the notification type, and `status` only represents the order status at the time of notification.


```json
{
  "notify_type": "REFUND.SUCCESS",
  "error_code": "0000",
  "error_description": "request success",
  "merchant_id": "18356675194960",
  "trans_id": "m58129512",
  "refund_order_id": "RG20324325320129",
  "order_id": "GW2056xxxxx2136685",
  "status": "SUCCESS",
  "amount": 2,
  "currency": "USD",
  "pay_finish_time": "2025-04-18T19:34:34+08:00"
}
```

### Refund Failure Notification

When a transaction order refund fails, a refund failure notification will be triggered. The field `notify_type` represents the notification type, and `status` only represents the order status at the time of notification.


```json
{
  "notify_type": "REFUND.FAILURE",
  "error_code": "2010",
  "error_description": "The bookkeeping has failed for the refund",
  "merchant_id": "18356675194960",
  "trans_id": "m58129512",
  "refund_order_id": "RG20324325320129",
  "order_id": "GW2056xxxxx2136685",
  "status": "FAILURE",
  "amount": 300,
  "currency": "USD",
  "pay_finish_time": "2025-04-22T13:53:10+08:00"
}
```