Create Deposit Order (CNY)
API for creating a Chinese Yuan (CNY) deposit order.
Request Information
- Request URL:
/gateway/api/v2/payments - Method:
POST - Content-Type:
application/json;charset=utf-8
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| platform_id | Yes | String(6) | Merchant ID |
| service_id | Yes | String(7) | Service ID |
| payment_cl_id | Yes | String(64) | Merchant Order ID |
| amount | Yes | Integer(10) | Amount (in cents) |
| notify_url | Yes | String(256) | Callback URL for transaction results |
| return_url | No | String(256) | Merchant return URL, supported by some payment methods. https only; at most 256 characters; printable ASCII characters only (no spaces). Include the exact provided value in the signature; an unsigned value is ignored |
| bank_name | No | String(16) | Bank code, see Bank List |
| name | No | String(16) | Payer name |
| request_time | Yes | Integer(10) | Request time (in seconds) |
| sign_type | No | String(16) | Signature type, fixed value HMAC-SHA256 |
| sign | Yes | String(32|64) | Order Signature |
Service IDs
Service Availability
The following are commonly used Service IDs. Please refer to the service IDs provided by your account manager for actual available services.
SVC0001Bank Card DepositSVC0002Bank Card Top-upSVC0008WeChat QR CodeSVC0010Alipay QR CodeSVC0011Alipay H5
Response Example
Success Response
{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 10000
}
}
Remarks
- Transaction amount is in Chinese Yuan (cents). Please multiply by 100 before passing
- Request time uses Unix timestamp in seconds
- Transaction results will be sent to
notify_url. See Deposit Notification for parameter specifications return_urlis an optional merchant return URL supported by some payment methods. The field is ignored when omitted or not included in the signature- Percent-encode non-ASCII URL components before sending. The complete encoded URL must not exceed 256 characters. Sign the final URL value exactly as provided; do not encode or modify it again after signing
- A user returning to the page specified by
return_urldoes not indicate a successful payment. Use thenotify_urlnotification or the order query API to determine the transaction result