支付回调

应用场景

支付完成后，会把相关支付结果及用户信息通过数据流的形式发送给商户，商户需要接收处理，并按文档规范返回应答。

接口链接

该链接是通过向客服提交回调接口，如果链接无法访问，商户将无法接收到通知。

通知url必须为直接可访问的url，不能携带参数。

签名sign生成

1.对参数按照key=value的格式，并按照参数名ASCII字典序排序生成字符串：

a=1&b=2&c=3

2.连接商户key：

a=1&b=2&c=3&key=dc30b*****15832

3.生成sign并转成大写：

sign=84B3FE3FDA6FC5A5786D8548EDC8BD74

返回数据

参数名	返回值类型	备注	其他信息
merchantNum	string	商户号
merchantName	string	商户名称
terminalNum	string	终端号	需要绑定收款设备
cashierNum	string	收银员编号	需要绑定收款设备
transCardNum	string	用户标识	微信为openid，支付宝为交易卡号
channelType	string	通道名称
promotionDetail	string	微信回传优惠信息
alipayCoupon_detail	string	支付宝回传优惠信息
attach	string	附件信息
relationOrderNumber	string	商户订单号	商户自己定义的订单号
orderNumber	string	平台订单号
orderPrice	number	订单金额	单位:分
orderRealyPrice	number	用户实付金额	单位:分
orderStatus	number	订单状态	0未支付 1已支付 2已退款 3已取消
orderType	number	订单类型	1微信 2支付宝 3百度钱包 4沃支付 5翼支付 6云闪付 7刷卡 8QQ钱包
orderNotifyUrl	string	订单回调地址	回调地址需要通过运营进行绑定或在后台进行绑定
orderNotifyStatus	number	回调状态	0未回调 1已回调
officialOrderNumber	string	官方交易编号	包含支付宝交易编号，微信交易编号，银行交易编号
orderPayAt	string	支付时间	格式yyyy-MM-dd HH:mm:ss
createdAt	string	创建时间	格式yyyy-MM-dd HH:mm:ss
orderTitle	string	订单标题
sign	string	签名

返回示例代码

json格式返回代码示例

{
        "relationOrderNumber": "tes****3",
        "orderNumber": "202105171******1487493",
        "orderPrice": 1,
        "orderRealyPrice": 0,
        "orderStatus": 0,
        "orderType": 2,
        "orderNotifyUrl": "http://test-pay.vv-tool.com/********y/2",
        "orderNotifyStatus": 0,
        "officialOrderNumber": "****",
        "orderPayAt": null,
        "createdAt": "2021-05-17T03:18:07.000000Z",
        "orderTitle": "测试",
        "merchantNum": "22****2",
        "merchantName": "***",
        "terminalNum": "***",
        "cashierNum": "*2***",
        "transCardNum": "**42***",
        "channelType": "****",
        "promotionDetail": "*****",
        "alipayCouponDetail": "****",
        "attach": "******"
    }