公用接口-下单支付/退款 结果通知

接口描述

跨境系统把支付结果/退款结果通过调用商户下单时指定的url,通知给商户订单的支付/退款 结果和其他订单相关信息
页面回调和服务器回调参数完全一致,服务器回调支持POST/GET,需入网时说明,并在后台做配置,默认为POST
页面回调只支持GET
商户接收并正常处理完成后,需要采用流回写的形式,返回"SUCCESS"字符串。否则系统会每隔2分钟通知一次,共通知10次。

回调参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) ALIPAYSCAN/WXPAYSCAN/ONLINEB2B/ONLINEB2C/QUICKPAY 订单对应的实际业务对应的产品编码
商户订单号 orderNo String(64) p_20170302185347
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
加密信息 content String 使用aes解密 详细信息见下表格
签名信息 sign String 使用sha256生成签名 详细信息见下表格

加密/签名参数详情

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) ALIPAYSCAN/WXPAYSCAN/ONLINEB2B/ONLINEB2C/QUICKPAY 订单对应的实际业务对应的产品编码
商户订单号 orderNo String(64) p_20170302185347
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
平台流水号 serialNumber String(32) 201702241400010002 合利宝-跨境系统生成的唯一交易流水号
订单状态 orderStatus String(20) SUCCESS/INIT 下单:(支付成功:SUCCESS,未支付:INIT) 退款:(退款成功:SUCCESS 退款失败:FAIL 退款关闭:CLOSE)
订单金额 orderAmount Number(10.2) 0.01 单位:元
订单创建时间 createDate String(20) 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss
完成时间 finishDate String(20) 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss
商品描述 goodsName String(400) Iphone7 退款通知时 此参数为空!!!
退款失败原因 remark String(150) 退款总金额超限 下单支付结果通知时 此参数为空!!!
渠道流水号 consumeOrderId String(128) 对应实际支付渠道的流水号
渠道标识 chanlType String(20) WANGLIAN或UNIONPAY
绑卡ID bindId String(20) 绑卡ID

代码示例

    @Test
    public void callBackTest() {
        HeliRequest heliRequest = new HeliRequest();
        // 加密信息
        heliRequest.setContent("");
        // 签名信息
        heliRequest.setSign("");
        heliRequest.setOrderNo("");
        // ONLINEB2B为例
        HandleDataUtils.decodeCallBack(heliRequest, ProductEnumType.ONLINEB2B.name(), LoadPropertiesUtils.getProperty("merchantNo"));
    }                       

                                

                                

错误码

错误码 错误码描述 解决方案