发起付款接口

接口地址

请求方式:HTTP POST
请求地址:http://btcside.com/get_qrcode_link

参数列表

参数名 含义 类型 必填/选填 说明
uid 用户ID string 必填 您的唯一标识,注册后在“接口参数配置”页面里获得。一个24位字符串
money 金额 double/float 必填 发起付款的金额,单位:元,精确到小数点后两位。
channel 渠道 string 必填 支付宝-参数:alipay、微信-参数:wechat、云闪付-参数:unionpay、支付宝转银行卡-参数:alipaybank、支付宝当面付-参数:alipayf2f、支付宝红包-参数:alipaybag、聊天宝-参数:bullet、钉钉-参数:dingding
post_url 通知接口地址 string 必填 用户支付成功后,凯泽支付服务器会POST调用这个链接,并携带一系统参数,具体参数请查看付款成功回调接口。
return_url 跳转地址 string 必填 用户支付成功后,我们会让用户浏览器自动跳转到这个网址。由您自定义。
order_id 订单号 string 必填 您这边的订单号,这个参数在通知接口里会回传给您的通知接口地址
order_uid 用户编号 string 选填 我们会显示在您后台的订单列表中,方便您看到是哪个用户的付款,方便后台对账。建议填写。可以填用户名,也可以填您数据库中的用户id。例:xxx, xxx@aaa.com
goods_name 商品名 string 选填 您的商品名称,用来显示在后台的订单名称。
key MD5验签 string 必填 此字段为uid+auth_code+money+channel+post_url+return_url+order_id+order_uid+goods_name进行字符串拼接后再进行md5-32位加密后的值。伪代码示例:md5(uid+auth_code+money+channel+post_url+return_url+order_id+order_uid+goods_name)

接口返回值 json

参数名 含义 类型 说明
code 状态码 int 状态码,用于标记接口的请求状态,200代表成功,其他代码表示请求失败,失败原因看msg字段
msg 请求状态描述 string 用于扫描状态码的说明信息,如:“接口调用成功”、“uid和auth_code 无法通过验证 请检查这两参数配置是否正确”
channel 渠道 string 支付平台,支付宝或者微信 alipay wechat 这两个值
money 金额 double/float 金额
realName 收款人全称 String 收款人全称,因为支付宝大额付款时会要求验证收款人全称,可将此字段展示在付款页面,可提高成功率。
qrcode 原生二维码字符串 string 原生二维码内容字符串,将此字符串转成二维码图片展示给用户扫描即可。原生的,H5 转帐码等情况要自己进行封装处理。
pcQrcode PC端二维码字符串 string PC端二维码内容字符串,将此字符串转成二维码图片展示给用户扫描即可。建议使用此字段,已封装过。
h5Qrcode 手机端跳转链接 string 手机端(h5 wap) 跳转链接 在浏览器里跳转到此字段链接即可。服务端跳转,js跳转均可。请注意:仅支持支付宝。

以下是返回样例

请求成功

{"msg":"接口调用成功","code":200,"qrcode":"https://qr.alipay.com/fkx00651vxroy6sal0emq95","pcQrcode":"https://qr.alipay.com/fkx00651vxroy6sal0emq95","h5Qrcode":"alipays://platformapi/startapp?appId=20000067&url=https%3A%2F%2Fqr.alipay.com%2Ffkx00651vxroy6sal0emq95","channel":"alipay","money":1.0,"realName":"李志东"}
{"msg":"接口调用成功","code":200,"qrcode":"alipays://platformapi/startapp?appId=09999988&actionType=toAccount&goBack=NO&amount=1.0&userId=2088332592634360&memo=家用抽纸","pcQrcode":"alipays://platformapi/startapp?appId=20000067&url=http%3A%2F%2Fwww.paysdog.com%2Fh5%2Falipay_h5.jsp%3Furl%3Dalipays%253A%252F%252Fplatformapi%252Fstartapp%253FappId%253D09999988%2526actionType%253DtoAccount%2526goBack%253DNO%2526amount%253D1.0%2526userId%253D2088332592634360%2526memo%253D%25E5%25AE%25B6%25E7%2594%25A8%25E6%258A%25BD%25E7%25BA%25B8","h5Qrcode":"alipays://platformapi/startapp?appId=20000067&url=http%3A%2F%2Fbtcside.com%2Fh5%2Falipay_h5.jsp%3Furl%3Dalipays%253A%252F%252Fplatformapi%252Fstartapp%253FappId%253D09999988%2526actionType%253DtoAccount%2526goBack%253DNO%2526amount%253D1.0%2526userId%253D2088332592634360%2526memo%253D%25E5%25AE%25B6%25E7%2594%25A8%25E6%258A%25BD%25E7%25BA%25B8","channel":"alipay","money":1.0,"realName":"李志东"}

请求失败

{"msg":"money 参数不能为空 且不能为负数","code":500,"qrcode":"","pcQrcode":"","h5Qrcode":"","channel":"alipay","money":-1.0,"realName":""}
{"msg":"uid和auth_code 无法通过验证 请检查这两参数配置是否正确","code":500,"qrcode":"","pcQrcode":"","h5Qrcode":"","channel":"","money":0.0,"realName":""}
{"msg":"心跳模式超时失败 请检查app的运行模式 或者查看 app是否在工作中","code":400,"qrcode":"","pcQrcode":"","h5Qrcode":"","channel":"","money":0.0,"realName":""}