Transaction QRcode payment

介绍

Transaction QR Code交易会对每笔订单生成一个动态的二维码,用户只需要扫该二维码即可进行支付,不需要输入金额。但是该场景需要用户能正常访问互联网。

流程

participant 用户
商户->scanforpay: 1. 创建订单
scanforpay->支付平台: 2. 创建订单
支付平台->scanforpay: 3. 返回订单信息及订单二维码
scanforpay->商户: 4. 返回订单信息及订单二维码
用户->商户: 5.扫描二维码进行支付
用户->支付平台: 6. 发起支付
支付平台-->用户: 7. 通知支付结果
支付平台-->scanforpay: 7. 通知支付结果
scanforpay-->商户: 8. 通知支付结果

订单创建

请求地址

POST

https://pay.scanforpay.com/api/offline/create
业务请求数据
名称 参数名 数据类型 必填 说明
门店编号 storeNo String (15) Y 由scanforpay分配
商户订单号 partnerOrderNo String (32) Y 由商户生成
20180802100000001
支付钱包 wallet String (10) Y Wechat: 微信支付
Alipay: 支付宝
交易金额 orderAmount int Y 交易币种的最小单位
如果商家币种是人民币,则100表示100分=1元;如果商家币种是日元,则100表示日元的 100元
交易说明 orderTitle String(100) N 对交易的说明
操作员 operatorId String(20) N 由商户填写 100001
终端编号 terminalNo String(20) N 由商户填写 100002
支付成功通知地址 notifyUrl String(200) N 如果填写,则支付成功后会通知到该地址,商户需处理重复通知的情况.
如果不填,则支付成功不会进行通知。
二维码过期时间 it_b_pay String(10) N 指定从用户扫描二维码开始,用户可以完成付款的时间段。时间一到,交易就会自动结束。默认情况下,此字段的值为3m。该字段的值在1m-15d的范围内。
注意:
1、 以下缩写用于表示时间单位:
m: 分钟
h: 小时
d: 天
c: 当日(无论何时创建交易,都将在0:00关闭)。
2、 该参数数值的小数点被拒绝,例如1.5h需要转换为90m。
示例:1d
二维码过期时间 qr_code_it_b_pay String(10) N 指定用户从创建二维码起可以完成付款的时间段。时间一到,交易就会自动结束。此字段的值在1m-2h的范围内。如果指定了此参数,则it_b_pay参数将无效。
注意:
1、 以下缩写用于表示时间单位:
m: 分钟
h: 小时
2、 该参数数值的小数点被拒绝,例如1.5h需要转换为90m。
示例:1m
请求示例
{
    "request": {
        "header": {
            "requestTime": "2018-07-25T17:53:52+08:00",
            "partnerNo": "10001",
            "signType": "SHA256",
            "version": "1.0",
            "reqMsgId": "615c1195-0cd0-421c-b612-538bf03eabc7"
        },
        "body": {
            "storeNo": "100010000000002",
            "partnerOrderNo": "p20180725175352983070",
            "wallet": "Alipay",
            "orderAmount": 2000,
            "orderTitle": "Consume",
            "operatorId": "211918"
        }
    },
    "signature": "d02a1a795d3878d4cea551f55091bcf9fb05efcfda289e7bc781e2ceefa8a931"
}
响应数据
名称 数据标识 数据类型 必填 说明
响应码 code int(5) Y 1:成功 其他为交易失败
响应信息 msg varchar (100) Y 响应信息
付款二维码 qrcode varchar(100) Y 二维码内容
支付订单号 orderNo varchar(32) Y 由scanforpay生成
商户订单号 partnerOrderNo String (32) Y 由商户生成
20180802100000001
二维码图片(大图) qrcodeImageL varchar(200) Y 二维码图片大图
二维码图片(正常) qrcodeImageM varchar(200) Y 二维码图片正常大小
二维码图片(小图) qrcodeImageS varchar(200) Y 二维码图片小图
响应示例
成功响应示例
{
    "response": {
        "header": {
            "partnerNo": "10001",
            "respTime": "2018-07-25T17:54:11+08:00",
            "signType": "SHA256",
            "version": "1.0",
            "reqMsgId": "a47ceb57-9c1c-4190-88ec-30ae1e413d89"
        },
        "body": {
            "code": 1,
            "msg": "success",
            "orderNo": "2018072517535241",
            "partnerOrderNo": "p20180725175352983070",
            "qrcode": "https://qr.alipay.com/bax01968y4zlr8n4usrb40b7",
            "qrcodeImageS": "https://mobilecodec.alipay.com/show.htm?code=bax01968y4zlr8n4usrb40b7&picSize=S",
            "qrcodeImageM": "https://mobilecodec.alipay.com/show.htm?code=bax01968y4zlr8n4usrb40b7&picSize=M",
            "qrcodeImageL": "https://mobilecodec.alipay.com/show.htm?code=bax01968y4zlr8n4usrb40b7&picSize=L",
        }
    },
    "signature": "a90a7457b39304645bf6eb18383e60d96c23361d238f319c6b6d5511c7044432"
}
失败响应示例
{
    "response": {
        "header": {
            "partnerNo": "10001",
            "respTime": "2018-07-25T17:37:14+08:00",
            "signType": "SHA256",
            "version": "1.0",
            "reqMsgId": "c11fe1c7-069b-4399-be00-31830a5de63d"
        },
        "body": {
            "code": 30
            "msg": "订单不存在",
        }
    },
    "signature": "5719065ecea463366cbf39b728b9b8cba940365c0c053dd96effde57f7edc1f8"
}

results matching ""

    No results matching ""