1. Webhook
WPay
  • Introduction
  • Signature
  • API Keys
  • Get Started
  • Webhook Service
  • Api Reference
    • Authentication
      • Get Access Token
      • Refresh Access Token
    • WPay
      • Hosted Payment Page
      • List Payment History
      • Get Payment Detail
      • Refund
      • List Subscriptions
      • Get Subscription Detail
      • Cancel Subscription
      • Get Subscription Bills
    • Webhook
      • WPayWebhook
        POST
  • Schemas
    • Schemas
      • RefundOrderDTO
      • RefundPageReq
      • ApiPageApiPageRefundOrderDTO
      • ApiResponseApiPageRefundOrderDTO
      • CancelReq
  1. Webhook

WPayWebhook

Developing
POST
Please implement a WCheckout webhook in your project according to this API to receive event notifications from WCheckout. You can define the endpoint path yourself. We will push events such as order status changes and abnormal payment alerts to this endpoint.

Request

Body Params application/jsonRequired

Example
{
    "eventId": "evt_0a4fee0f8882",
    "eventType": "PAY_ORDER",
    "timestamp": 1758701681,
    "data": {
        "mchOrderNo": "xxxxxxxx",
        "amount": "818.89",
        "status": "PAID",
        "createdTime": "2025-12-23 12:56:47",
        "updatedTime": "2025-12-23 12:56:47"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '' \
--header 'Content-Type: application/json' \
--data '{
    "eventId": "evt_0a4fee0f8882",
    "eventType": "PAY_ORDER",
    "timestamp": 1758701681,
    "data": {
        "mchOrderNo": "xxxxxxxx",
        "amount": "818.89",
        "status": "PAID",
        "createdTime": "2025-12-23 12:56:47",
        "updatedTime": "2025-12-23 12:56:47"
    }
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "success": true,
    "retcode": 200
}
Modified at 2026-05-26 03:39:28
Previous
Get Subscription Bills
Next
RefundOrderDTO
Built with