China Payin
Create payin
POST /api/v1/merchant/payin/create
| Field | Required | Notes |
|---|---|---|
merchantOrderNo | yes | Unique per merchant |
countryCode | yes | CN |
currency | yes | CNY |
amount | yes | > 0 |
notifyUrl | no | Webhook URL |
metadata | no | Payer info, biz ref |
Response includes orderNo (PI…), feeAmount, netAmount, status (created initially).
Query payin
GET /api/v1/merchant/payin/query?orderNo= or ?merchantOrderNo=
Webhook (completed)
Full checklist: Webhook guide.
POST JSON with signed headers.
json
{
"orderType": "payin",
"orderNo": "PI...",
"merchantOrderNo": "...",
"status": "completed",
"amount": "5000.00",
"feeAmount": "15.00",
"netAmount": "4985.00",
"currency": "CNY",
"countryCode": "CN",
"completedAt": 1718209200
}Respond 200 + OK. Verify signature before updating order state.
Statuses: created, processing, completed, failed, cancelled.