Create Withdraw Order (CNY - UnionPay)

Create a CNY (Chinese Yuan) UnionPay withdrawal order.

Request Information

• Request URL: /gateway/api/v2/payouts
• Request Method: POST
• Content-Type: application/json;charset=utf-8

Request Parameters

Parameter	Required	Type	Description
platform_id	Yes	String(7)	Merchant ID
service_id	Yes	String(7)	Service ID, use fixed value SVC0062
payout_cl_id	Yes	String(32)	Merchant Order ID
amount	Yes	Integer(10)	Amount (in cents)
notify_url	No	String(256)	Transaction result notification URL
name	Yes	String	UnionPay account name
number	Yes	String	UnionPay account number
request_time	Yes	Integer(10)	Request time (Unix timestamp in seconds)
sign	Yes	String(32)	Order Signature

Request Example

{
  "amount": "50000",
  "name": "test_name",
  "notify_url": "https://xxx.xx/notification",
  "number": "test",
  "payout_cl_id": "DEVPOT00143538",
  "platform_id": "PF0002",
  "request_time": "1595504997",
  "service_id": "SVC0062",
  "sign": "8ac38fb87c2bcce4cf36627d4f8aa747"
}

Response Example

Success Response

{
  "error_code": "0000",
  "data": {
    "payout_id": "POT00000001"
  }
}

Error Response Example

{
  "error_code": "0004",
  "error_msg": "Signature verification failed!"
}

Response Parameter Description

Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error message (returned when error_code is not "0000")
payout_id	String	Platform order ID

Remarks

Important Notice

Due to network fluctuations, high concurrency, attacks and other force majeure factors, if you encounter timeout, HTTP 500 error, empty response, or network delay when calling the withdrawal API, please use the Order Query API status as reference, or contact operations personnel with the merchant order number for manual verification. The platform is not responsible for any losses caused by rejecting withdrawal orders without manual confirmation from operations personnel!

• Merchant ID is a unique identifier assigned by the system. If not obtained, please contact system personnel.
• Service ID: use SVC0062 (UnionPay Withdrawal)
• Transaction amount unit is CNY (cents)
• Request time uses Unix timestamp in seconds
• Returning "0000" only indicates the API call was successful, not the transaction status. Please call the Query API to confirm the result.
• If server response is not received (e.g. 5xx HTTP status), you must call the Query API or wait for callback. Do not treat the order as failed directly.