1. request message#
| http message headers | | | | | |
|---|
| Field | field Description | Type | Required (M)/ can select (O) | value range or format | business rules |
| x-signature | Signature | C | M | {Signature} | non-File Upload API for entire body perform Signature; File Upload API for checksum perform Signature |
| x-app-id | Partner apply ID | C | M | | is Partner apply assign of unique apply ID |
| x-request-id | request ID | C | M | | Partner system globally unique, and business no related |
| http message body | | | | | |
|---|
| Field | field Description | Type | Required (M)/ can select (O) | value range or format | business rules |
| business Data | request business Data | C | M | json format | See specific API definition |
request message example:
POST /api/v1/ex/onboarding/merchant HTTP/1.1
Host: api.eurewax.com
Content-Type: application/json
x-signature: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
x-app-id: APP2023112700001
x-request-id: REQ20231127160523789001
{
"orderId": "ORD20231127001",
"orderAmount": 1000.00,
"currency": "CNY",
"userId": "USR10001",
"productList": [
{
"productId": "PROD001",
"quantity": 2,
"price": 500.00
}
]
}
2. synchronous response message#
| http message headers | | | | | |
|---|
| Field | field Description | Type | Required (M)/ can select (O) | value range or format | business rules |
| x-signature | Signature | C | M | {Signature} | for entire body perform Signature |
| x-app-id | Partner apply ID | C | M | | |
| x-request-id | request ID | C | M | | |
| http message body | | | | | |
|---|
| Field | field Description | Type | Required (M)/ can select (O) | value range or format | business rules |
| code | Response Code | C | M | business Processed Successfully: 0; Otherall indicates business Processing Failed | business processing Status |
| message | response Information | C | M | | Description specific Information |
| data | responseData | C | O | json format | See specific API definition |
| | | | | |
Processed Success fully synchronous response example:
HTTP/1.1 200 OK
Content-Type: application/json
x-signature: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
x-app-id: APP2023112700001
x-request-id: REQ20231127160523789001
{
"code": "0",
"message": "Processed Successfully",
"data": {
"transactionId": "TRX20231127001",
"orderStatus": "ACCEPTED",
"processingTime": "20230101120000",
"details": {
"paymentLink": "https://payment.example.com/pay/TRX20231127001",
"expiryTime": "20230101120000"
}
}
}
Processing Failed synchronous response example:
HTTP/1.1 200 OK
Content-Type: application/json
x-signature: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
x-app-id: APP2023112700001
x-request-id: REQ20231127160523789001
{
"code": "E0010001",
"message": "parameter Verification Failure: Order Amountnot can is empty",
"data": null
}
3. asynchronous Notification message#
| http message headers | | | | | |
|---|
| Field | field Description | Type | Required (M)/ can select (O) | value range or format | business rules |
| x-signature | Signature | C | M | {Signature} | for entire body perform Signature |
| http message body | | | | | |
|---|
| Field | field Description | Type | Required (M)/ can select (O) | value range or format | business rules |
| | | | | |
| business Data | asynchronous Notification of Result business Data | C | M | json format | See specific Notification API definition |
asynchronous Notification message example:
POST /api/callback/payment HTTP/1.1
Host: partner.example.com
Content-Type: application/json
x-signature: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
{
"notifyType": "PAYMENT_STATUS",
"orderId": "ORD20231127001",
"transactionId": "TRX20231127001",
"orderStatus": "PAID",
"paymentAmount": 1000.00,
"paymentTime": "20230101120000",
"paymentMethod": "WECHAT",
"notifyId": "NOT20231127001",
"notifyTime": "20230101120000"
}
Modified at 2026-08-08 08:28:31
