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 |
| 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: HMAC-SHA256 (recommended) or MD5 (default) |
| 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 Code
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