qimen.alibaba.uni.trade.pay (全域收单交易支付接口)

全域收单支付接口,承载两个独立功能 *.用于在零售商自己完成支付后将支付结果同步给零售核心 *.用于请求平台发起支付

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
storeId String 必须 100004 门店ID
tradeNo String 可选 20180111000001595051 零售核心订单号,和外部订单号不能同时为空
outTradeNo String 可选 OT39472389645 业务方自有订单号,和零售核心订单号不能同时为空
actualPayAmount String 必须 15000 实付金额,单位:分(人民币)
customFundBillList RcCustomFundBill [] 可选
  • 最大列表长度:20
  • 自定义资金渠道明细
    • └ fundBillId
    • String
    • 可选
    • 38923642374
    • 资金渠道ID,比如支付宝单号,微信单号,代金券编号,优惠券编号
    • └ fundBillName
    • String
    • 必须
    • 满100减10
    • 资金渠道名称,比如支付宝钱包,微信支付,xxx代金券,xxx优惠券
    • └ amount
    • Number
    • 必须
    • 1000
    • 对应资金渠道金额 单位分
    paySetting Struct 可选 支付设置,如无需平台做支付,请勿设置该字段
    • └ agreementNo
    • String
    • 可选
    • 2018011843846736
    • 支付宝协议支付,协议号;当payChannel为AGREEMENT的时候必填
    • └ payChannel
    • String
    • 必须
    • alipay_w
    • alipay_w|agreement
    • └ payCode
    • String
    • 必须
    • 20887836473287
    • 当payChannel为ALIPAY_W时为当面付支付码;当payChannel为AGREEMENT时为用户支付宝账号
    storeIdType String 必须 RPLIS 门店Id类型,RPLUS:零售+门店ID; PLACE:商户中心门店ID; CUSTOM:自有门店ID,须在商户中心有映射关系
    payTime String 可选 2018-01-12:34:23 同步支付结果时必填,消费浙付款时间

    响应参数

    名称 类型 示例值 描述
    success Boolean true 业务成功标识 true|false
    errCode String 601 错误码
    errMsg String 无效参数 错误描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlibabaUniTradePayRequest req = new AlibabaUniTradePayRequest();
    req.setStoreId("100004");
    req.setTradeNo("20180111000001595051");
    req.setOutTradeNo("OT39472389645");
    req.setActualPayAmount("15000");
    List<AlibabaUniTradePayRequest.RcCustomFundBill> list2 = new ArrayList<AlibabaUniTradePayRequest.RcCustomFundBill>();
    AlibabaUniTradePayRequest.RcCustomFundBill obj3 = new AlibabaUniTradePayRequest.RcCustomFundBill();
    list2.add(obj3);
    obj3.setFundBillId("38923642374");
    obj3.setFundBillName("满100减10");
    obj3.setAmount(1000L);
    req.setCustomFundBillList(list2);
    AlibabaUniTradePayRequest.Struct obj4 = new AlibabaUniTradePayRequest.Struct();
    obj4.setAgreementNo("2018011843846736");
    obj4.setPayChannel("alipay_w");
    obj4.setPayCode("20887836473287");
    req.setPaySetting(obj4);
    req.setStoreIdType("RPLIS");
    req.setPayTime("2018-01-12:34:23");
    AlibabaUniTradePayResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <success>true</success>
    <errCode>601</errCode>
    <errMsg>无效参数</errMsg>
    

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部