Stablecoin Payment Order Message Push

Stablecoin Payment Webhook

When the status of a stablecoin payment order changes, the system sends an event notification to the merchant’s pre-configured endpoint via Webhook.

The webhook mechanism enables merchants to receive real-time payment updates without actively polling the order query APIs.

• The webhook payload includes core order information and blockchain-related transaction data

• Merchants should properly handle the webhook request

• A successful HTTP 200 response is recommended to acknowledge receipt

---

Webhook Event

Event Type: STABLE_COIN_PAYMENT_WEBHOOK

---

Webhook Payload

The webhook request body contains the following parameters:

• webhookId: Unique identifier for the webhook event.

• eventType: Event type identifier.

• orderId: Payment order ID.

• userId: User identifier.

• merchantId: Merchant identifier.

• linkId: Payment link ID.

• walletId: Wallet identifier.

• walletName: Wallet name.

• referenceId: Merchant reference number.

• currency: Currency type.

• network: Blockchain network identifier.

• networkName: Blockchain network name.

• depositAmount: Deposit amount.

• feeAmount: Transaction fee.

• receivedAmount: Actual received amount.

• status: Order status (e.g., CONFIRMED).

• fromAddress: Sender wallet address.

• toAddress: Receiver wallet address.

• txHash: Blockchain transaction hash.

• paymentLink: Payment link URL.

• createTime: Order creation timestamp.

• cancelTime: Order cancellation timestamp.

• processTime: Processing timestamp.

• confirmTime: Confirmation timestamp.

---

Webhook Example

{
  "webhookId": "ebab8a9663704e7cbbebe672c7c67912",
  "eventType": "STABLE_COIN_PAYMENT_WEBHOOK",
  "orderId": 1234567890,
  "userId": 9876543210,
  "merchantId": 42,
  "linkId": 56789,
  "walletId": 10001,
  "walletName": "Main USDT Wallet",
  "referenceId": "REF-2024-05-03-001",
  "currency": "USDT",
  "network": "ethereum",
  "networkName": "Ethereum Mainnet",
  "depositAmount": 1000.00,
  "feeAmount": 2.50,
  "receivedAmount": 997.50,
  "status": "CONFIRMED",
  "fromAddress": "0x1234567890abcdef1234567890abcdef123456789",
  "toAddress": "0x9876543210fedcba9876543210fedcba98765432",
  "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd",
  "paymentLink": "https://payment.example.com/pay/123456",
  "createTime": 1714671600000,
  "cancelTime": null,
  "processTime": 1714672200000,
  "confirmTime": 1714672800000
}

---

Notes

• Merchants must configure a publicly accessible webhook endpoint to receive event notifications.

• The webhook will be triggered when the payment order status changes.

• Merchants should return HTTP 200 to confirm successful receipt of the webhook event.

• All timestamps are returned in Unix milliseconds. - Stablecoin Payment Webhoo