Webhooks

This section provides a list of possible events that can be received as webhooks for Payin Transactions.

To enable real-time updates between APARA and customers, we send a series of events throughout the order lifecycle.

Order statuses

Events	Event Type	Status	Description
Payment Initiated	Order	initiated	Post confirming the order details, wallet address, and payment method selection, the user will be redirecting to the payment checkout page
Payment Processing	Order	fund_processing	The payment has been received and is currently being processed.
Payment Authorised	Order	fund_settled	User has submitted the payment details on the payment checkout page and the confirmation is received from the bank
Payment Unauthorised	Order	fund_failed	User has submitted the payment details on the payment checkout page and the payment is declined from the bank
Expired	Order	expired	The order is expired due to transaction not completed by user.
Manual Review	Order	manual_review	The order is hold for manual review by our compliance team.

Sample Events

{
  "eventId": "EV-260626045534510",
  "entityId": "OR-2606260440212823157",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "OCUX-17806349026801627",
    "createdAt": "2026-06-05T04:48:22.684Z"
  },
  "order": {
    "orderId": "OR-2606260440212823157",
    "type": "payin",
    "fiatTicker": "VND",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 120002,
    "cryptoAmount": 0,
    "paymentType": "zalo",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2026-06-26T04:40:21.827Z",
    "custormerOrderId": "customerId123",
    "failureCode": "",
    "failureMessage": "",
    "withdrawAmount": 116402,
    "withdrawCurrency": "VND"
  },
  "createdAt": "2026-06-26T04:55:34.242Z"
}

{
  "eventId": "EV-260626045534510",
  "entityId": "OR-2606260440212823157",
  "entityType": "order",
  "status": "fund_processing",
  "user": {
    "userId": "OCUX-17806349026801627",
    "createdAt": "2026-06-05T04:48:22.684Z"
  },
  "order": {
    "orderId": "OR-2606260440212823157",
    "type": "payin",
    "fiatTicker": "VND",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 120002,
    "cryptoAmount": 0,
    "paymentType": "zalo",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2026-06-26T04:40:21.827Z",
    "custormerOrderId": "customerId123",
    "failureCode": "",
    "failureMessage": "",
    "withdrawAmount": 116402,
    "withdrawCurrency": "VND"
  },
  "createdAt": "2026-06-26T04:55:34.242Z"
}

{
  "eventId": "EV-260626045534510",
  "entityId": "OR-2606260440212823157",
  "entityType": "order",
  "status": "fund_settled",
  "user": {
    "userId": "OCUX-17806349026801627",
    "createdAt": "2026-06-05T04:48:22.684Z"
  },
  "order": {
    "orderId": "OR-2606260440212823157",
    "type": "payin",
    "fiatTicker": "VND",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 120002,
    "cryptoAmount": 0,
    "paymentType": "zalo",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2026-06-26T04:40:21.827Z",
    "custormerOrderId": "customerId123",
    "failureCode": "",
    "failureMessage": "",
    "withdrawAmount": 116402,
    "withdrawCurrency": "VND"
  },
  "createdAt": "2026-06-26T04:55:34.242Z"
}

{
  "eventId": "EV-260626045534510",
  "entityId": "OR-2606260440212823157",
  "entityType": "order",
  "status": "fund_failed",
  "user": {
    "userId": "OCUX-17806349026801627",
    "createdAt": "2026-06-05T04:48:22.684Z"
  },
  "order": {
    "orderId": "OR-2606260440212823157",
    "type": "payin",
    "fiatTicker": "VND",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 120002,
    "cryptoAmount": 0,
    "paymentType": "zalo",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2026-06-26T04:40:21.827Z",
    "custormerOrderId": "customerId123",
    "failureCode": "",
    "failureMessage": "",
    "withdrawAmount": 116402,
    "withdrawCurrency": "VND"
  },
  "createdAt": "2026-06-26T04:55:34.242Z"
}

{
  "eventId": "EV-260626045534510",
  "entityId": "OR-2606260440212823157",
  "entityType": "order",
  "status": "expired",
  "user": {
    "userId": "OCUX-17806349026801627",
    "createdAt": "2026-06-05T04:48:22.684Z"
  },
  "order": {
    "orderId": "OR-2606260440212823157",
    "type": "payin",
    "fiatTicker": "VND",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 120002,
    "cryptoAmount": 0,
    "paymentType": "zalo",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2026-06-26T04:40:21.827Z",
    "custormerOrderId": "customerId123",
    "failureCode": "",
    "failureMessage": "",
    "withdrawAmount": 116402,
    "withdrawCurrency": "VND"
  },
  "createdAt": "2026-06-26T04:55:34.242Z"
}

Was this page helpful?