跳到主要内容

创建出款单(人民币-云闪付)

创建人民币(CNY)云闪付代付订单接口。

请求资讯

  • 请求 URL: /gateway/api/v2/payouts
  • 请求方式: POST
  • Content-Type: application/json;charset=utf-8

请求参数

参数名必选类型说明
platform_idString(7)商户 ID
service_idString(7)服务 ID,请填入固定值 SVC0062
payout_cl_idString(32)商户订单号
amountInteger(10)金额(分)
notify_urlString(256)交易结果通知地址
nameString云闪付户名
numberString云闪付帐号
request_timeInteger(10)请求时间(秒)
sign_typeString(16)签名类型:HMAC-SHA256(推荐)或 MD5(默认)
signString(3264)

请求示例

{
"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"
}

返回示例

成功返回

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

错误返回示例

{
"error_code": "0004",
"error_msg": "验签错误!"
}

返回参数说明

参数名类型说明
error_codeString错误码
error_msgString错误讯息(error_code 不为 "0000" 时返回)
payout_idString平台订单号

备注

重要提示

因为存在网络波动、并发量过大、被攻击等不可抗力因素,如若在调用代付接口时遇到 超时、HTTP 500 错误、调用结果返回空白,或网络延迟时,请以 订单查询接口状态 为依据,或与运营人员取得联系,提供商户单号进行人工查询,由运营人员人工确认代付订单是否失败。 未经过运营人员人工确认就驳回代付订单所造成的损失,本平台概不负责!

  • 商户 ID 为系统分配之唯一识别,如尚未取得请联系系统人员
  • 服务 ID 请填入 SVC0062(云闪付代付)
  • 交易金额单位为人民币(分)
  • 请求时间使用 Unix timestamp,单位为秒
  • 返回 "0000" 时仅代表接口调用成功,并不表示交易状态,请调用查询接口确认结果
  • 如遇任何情况未取得 Server 回应(e.g. 5xx HttpStatus...),需调用查询接口或等待回调,不可直接视为订单失败