支付宝当面付
说明
- 调用方法为 POST, content-type 为 application/x-www-form-urlencoded
- 请求该接口可以获取支付二维码链接,可以将该链接生成二维码给用户扫码,或者直接跳转该链接拉起支付宝 app(俗称H5)(如果你用的是「聚合A」支付通道的支付宝支付需要在该链接前加 alipays://platformapi/startapp?appId=20000067&url= 才能拉起支付宝)
- 用户用手机扫码可以支付
接口地址
https://xorpay.com/api/pay/aid 其中 aid 为用户 appid,请在 XorPay 后台 查看后替换
接口参数
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
name | string | 是 | 商品名称 |
pay_type | string | 是 | alipay |
price | string | 是 | 价格如: 50.00 |
order_id | string | 是 | 你平台订单号,需要唯一 |
order_uid | string | 否 | 订单用户如: [email protected] |
notify_url | string | 是 | 回调地址 |
more | string | 否 | 订单其他信息,回调时原样传回 |
expire | int | 否 | 订单过期秒数,默认 7200 |
sign | string | 是 | 将参数按 name + pay_type + price + order_id + notify_url + app secret 顺序拼接后MD5(纯 value 拼接,不要包含 + 号) |
POST body 举例:
pay_type=alipay&name=XorPay+ %E8%B4%A6%E6%88%B7%E5%85%85%E5%80%BC&order_uid=a%40b.com&order_id=14&price=0.01&sign=23f 486d9bb15x6b11f753547558626d7¬ify_url=http%3A%2F%2Fexample.com%3A3094%2Fpay_callback
返回参数
返回为 json 格式
名称 | 类型 | 必有 | 说明 |
---|---|---|---|
status | string | 是 | 只有在 ok 的情况下才有后面的参数ok 成功no_contract 未签约no_alipay_contract 未签约支付宝missing_argument 缺少参数app_off 账号被冻结aid_not_exist aid不存在pay_type_error 支付类型错误sign_error 签名错误order_payed 订单已支付order_expire 订单过期alipay_api_error 并且 info 是 ACQ.ACCESS_FORBIDDEN 表示需要去支付宝发来的邮件里面点签约alipay_api_error 并且 info 是 aop.invalid-app-auth-token 联系客服处理fee_error 余额不足order_exist 同一订单,参数不同 |
aoid | string | 否 | XorPay 平台统一订单号 |
expire_in | int | 否 | 订单过期秒数 |
info | dict | 否 | qr 支付二维码 |
举例:
{u'status': u'ok', u'info': {u'qr': u'https://qr.alipay.com/baxbe6067atdzqfdxjcq20ff'}, u'expires_in': 7200, u'aoid': u'dfa20e231xf64069a615ecfme0m27x26'}
最后
返回结果里面 qr 既是支付二维码,用支付宝扫码即可支付;在大部分手机上(有小部分可能无法拉起支付宝app支付),跳转 qr 这个地址参数,可以拉起支付宝 app 支付(h5)
或者 手机跳转这个地址(url schema) 也可以拉起支付宝 App
alipays://platformapi/startapp?appId=20000067&url=http%3A%2F%2Fxorpay.com
url 参数替换为 qr