发起付款接口(必用接口)


接口URL:
http://121.41.20.164/api/v1/charges

网关地址请自行替换,上面的http://121.41.20.164仅供参考

传参方式:Post
请求参数:
# 参数名 含义 类型 必填 说明
1 uid 商户uid string 必填 您的商户唯一标识,注册后在设置里获得。
2 money 订单金额 string 必填 单位:元。精确小数点后2位。例:1021.16
3 channelType 支付通道类型 string 必填 固定值:alipay、wechat或unionpay
4 channel 支付通道编码 string 必填 指定支付通道编码。不传该参数则平台会自动选择可用通道。
5 outTradeNo 商户订单号 string 必填 您的唯一订单ID,必须全局唯一。
6 notifyUrl 通知回调网址 string 必填 用户支付成功后,我们会让用户浏览器自动跳转到这个网址。由您自定义。不要urlencode。例:http://www.aaa.com/paysucc_return
7 returnUrl 跳转网址 string 必填 用户支付成功后,我们会让用户浏览器自动跳转到这个网址。由您自定义。不要urlencode。例:http://www.aaa.com/paysucc_return
8 goodsName 商品名称 string 选填 您的商品名称,可以用来统计商品销售情况。
9 outUserId 付款用户id string 选填 我们会显示在您后台的订单列表中,方便您看到是哪个用户的付款,方便后台对账。强烈建议填写。可以填用户名,也可以填您数据库中的用户uid。例:xxx, xxx@aaa.com
10 timestamp 系统时间戳 string 必填 当前系统时间戳(单位毫秒)
11 sign 签名 string 必填 签名参数。把使用到的所有参数(sign本身和路径path参数除外)连同参数token一起,按参数名字母升序排序。然后按key1=value1&key2=value2形式拼接在一起。最后md5-32位加密取字符串大写得到sign参数字符串。注意不要urlencode

注意:token在安全上非常重要,一定不要显示在任何网页代码、网址参数中。只可以放在服务端。计算sign时,先在服务端计算好,把计算出来的sign传出来。严禁在客户端计算sign,严禁在客户端存储token。

SIGN参数签名的步骤如下:

第一步,设所有发送或者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串stringA。

特别注意以下重要规则:

  • 参数token参与计算签名时要一起按字典排序而不是直接加在最后面;
  • 参数名ASCII码从小到大排序(字典升序);
  • 网址类型的参数注意不要urlencode编码;
  • 参数名区分大小写;
  • 路径path参数不要参与签名;

第二步,对stringA进行MD5 32位大写计算,得到sign值。

参与签名计算参数示例:

channel=alipay_qrcode_fix&channelType=alipay&goodsName=测试&money=0.01&notifyUrl=http://www.xxxx.com/test/notify&outTradeNo=APP38921464&outUserId=app&returnUrl=http://www.xxxx.com/payResult.html&timestamp=1570725970166&token=095673886f0742d7a4be46bb3cd3bd57&uid=389215243663812608
			
响应参数:
# 参数名 含义 类型 说明
1 code 返回码 int(32) 0表示接口调用正常。非0表示异常
2 msg 提示信息 int(32) 对应返回码code的提示信息。
3 timestamp 时间戳 int(64) 服务器时间戳,可用来校时。
4 version 接口版本 string 用途暂时保留
5 data 数据对象 object
请求成功时返回示例:
{
  "code": 0,
  "msg": "调用成功。",
  "timestamp": "1555040027820",
  "version": "1.0",
  "data": {
	// 通道类型
    "channelType": "alipay",
	// 通道名称
    "channel": "alipay_hb",
	// 订单金额。单位:元。精确小数点后2位。例:1030.00
    "money": "0.01",
	// 用户实际需要支付的金额。单位:元。精确小数点后2位。例:1021.16
    "realMoney": "0.01",
	// 平台返回的订单号
    "tradeNo": "323232553241366528",
	// 商户自己的唯一订单号
    "outTradeNo": "APP323232553119731712",
	// 订单状态:1待支付,2支付成功,3已关闭
    "status": 2,
	// 支付地址。商户需要展示该地址给付款用户
    "payUrl": "https://www.xxxx.com/payment.html?p=DgLlHVQqblKNh242vXDGU/14wY72CQlB6Kjq7+kcTaWTrRBr/7AwjoPawz9fqO1v6yw&t=alipay",
    // 付款二维码图片地址。
	"qrcodeUrl": "https://www.xxxx.com/upload/qrcode/d58ecb9bf1734967a7e124f6605d59cfac.jpg",
	// 付款二维码图片内容。
    "qrcodeContent": "https://www.xxxx.com//pay/v1/go_pay?p=DgLlHVQqblKNh75643vXDGU/14wY72CQlB6Kjq7+kcTaWTrRBr/7AwjoPawz9fqO1v6yw&t=alipay",
    // 是否支付成功
	"paySucc": true,
    // 是否回调成功
	"notifySucc": true,
    // 订单有效截止时间yyyy-MM-dd HH:mm:ss,超出无法支付。默认5分钟
	"validTime": "2019-04-11 23:00:46",
    // 订单有效截止时间戳(毫秒),超出无法支付。默认5分钟
	"validTimeMills": "1554994846000"
  }
}
请求失败时返回示例:
{
  "code": 1012,
  "msg": "通道不存在或者不可用。",
  "data": null,
  "timestamp": "1554210357457",
  "version": "1.0"
}

付款成功回调通知


用户付款成功后,我们会向您在发起付款接口传入的notify_url网址发送通知。您的服务器只要返回内容:SUCCESS(注意是大写),就表示回调已收到。如果返回内容不是SUCCESS,我们会在10分钟内尝试回调3次。

注意:出于安全考虑,平台不提供补单功能。 即使在3次回调仍然失败的情况下,您还可以通过查询订单接口来获取支付状态后进行相应补单业务。

传参方式:Post
参数内容:
# 参数名 含义 类型 说明
1 channel 支付通道编码 string 商户下单时的支付通道编码
2 tradeNo 平台订单号 string 订单支付金额
3 outTradeNo 商户自己的订单号 string 商户下单时的私有唯一订单号
4 money 订单金额 string 单位元。商户下单时的金额
5 realMoney 实际订单金额 string 单位元。
6 uid 对应商户uid string
7 sign 签名 string 签名算法同上

付款成功自动跳转


用户付款成功后,我们会先通过调用notify_url接口,通知您服务器付款成功,然后引导用户跳转到return_url网址。