API接口目录

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.btborderpayonlineinfo.query 零售云b2b订单支付校验加签信息查询接口
¥免费

零售云b2b订单支付前校验及加签信息查询接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY111111调用方唯一编码
storeCodeStringY59021门店编码
logonUserNameStringY小B注册登录名小B注册登录名
channelTypeStringYPC 渠道(1.PC 2.WAP 3.SDK 4.TV)
versionStringNV1.2APP版本号(只有channelType 为SDK时有值)
appTypeStringN01app类型 只有channelType 为SDK时有值 01代表IOS 02代表安卓
deviceStringYapple手机型号
notifyUrlStringY通知URL,收银台调转URL通知URL,收银台调转URL
orderNosStringN
orderNoStringYA0315021214订单号
响应参数
名称 类型 示例值 描述
respBeanString
merchantNoString03232系统接入方
merchantDomainStringcnsuning.com交易发起方商户域名
responseCodeString999返回编码
responseMsgString返回信息描述返回信息描述
eppNetpayInfoString银联返回信息银联返回信息
publicKeyIndexString公钥索引公钥索引
inputCharsetString编码类型编码类型
notifyUrlString服务器异步通知URL服务器异步通知URL
returnUrlString页面跳转同步通知页面路径页面跳转同步通知页面路径
versionString1.2接口版本号
buyerUserNoString买家会员编号买家会员编号
signatureString签名签名
signAlgorithmString签名算法签名算法
submitTimeString提交时间提交时间
buyerMerchantNoString买家商户编号(企业专有)买家商户编号(企业专有)
buyerAliasString买家登录名买家登录名
buyerMerchantLoginNameString付款方商户会员登录名付款方商户会员登录名
buyerMerchantUserNoString付款方商户会员编号付款方商户会员编号
creditInstallmentString任性付期数任性付期数
payOtherFlagString易购代付订单标识易购代付订单标识
ordersString订单数据集订单数据集
payModesString任性付信息任性付信息
extraDataString额外字段额外字段
extDataString预留信息预留信息
bizSourceString业务类型业务类型
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryBtborderpayinfo>
      <orderNos>
        <orderNo>A0315021214</orderNo>
      </orderNos>
      <appType>01</appType>
      <appId>111111</appId>
      <notifyUrl>通知URL,收银台调转URL</notifyUrl>
      <channelType>PC </channelType>
      <version>V1.2</version>
      <device>apple</device>
      <storeCode>59021</storeCode>
      <logonUserName>小B注册登录名</logonUserName>
    </queryBtborderpayinfo>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryBtborderpayinfo": {
        "orderNos": [
          {
            "orderNo": "A0315021214"
          }
        ],
        "appType": "01",
        "appId": "111111",
        "notifyUrl": "通知URL,收银台调转URL",
        "channelType": "PC ",
        "version": "V1.2",
        "device": "apple",
        "storeCode": "59021",
        "logonUserName": "小B注册登录名"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryBtborderpayinfo>
      <respBean>
        <publicKeyIndex>公钥索引</publicKeyIndex>
        <payModes>任性付信息</payModes>
        <signature>签名</signature>
        <extraData>额外字段</extraData>
        <buyerMerchantLoginName>付款方商户会员登录名</buyerMerchantLoginName>
        <creditInstallment>任性付期数</creditInstallment>
        <responseCode>999</responseCode>
        <eppNetpayInfo>银联返回信息</eppNetpayInfo>
        <payOtherFlag>易购代付订单标识</payOtherFlag>
        <returnUrl>页面跳转同步通知页面路径</returnUrl>
        <signAlgorithm>签名算法</signAlgorithm>
        <buyerMerchantNo>买家商户编号(企业专有)</buyerMerchantNo>
        <buyerUserNo>买家会员编号</buyerUserNo>
        <responseMsg>返回信息描述</responseMsg>
        <buyerMerchantUserNo>付款方商户会员编号</buyerMerchantUserNo>
        <buyerAlias>买家登录名</buyerAlias>
        <version>1.2</version>
        <merchantDomain>cnsuning.com</merchantDomain>
        <submitTime>提交时间</submitTime>
        <bizSource>业务类型</bizSource>
        <extData>预留信息</extData>
        <notifyUrl>服务器异步通知URL</notifyUrl>
        <inputCharset>编码类型</inputCharset>
        <orders>订单数据集</orders>
        <merchantNo>03232</merchantNo>
      </respBean>
    </queryBtborderpayinfo>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryBtborderpayinfo": {
        "respBean": {
          "publicKeyIndex": "公钥索引",
          "payModes": "任性付信息",
          "signature": "签名",
          "extraData": "额外字段",
          "buyerMerchantLoginName": "付款方商户会员登录名",
          "creditInstallment": "任性付期数",
          "responseCode": "999",
          "eppNetpayInfo": "银联返回信息",
          "payOtherFlag": "易购代付订单标识",
          "returnUrl": "页面跳转同步通知页面路径",
          "signAlgorithm": "签名算法",
          "buyerMerchantNo": "买家商户编号(企业专有)",
          "buyerUserNo": "买家会员编号",
          "responseMsg": "返回信息描述",
          "buyerMerchantUserNo": "付款方商户会员编号",
          "buyerAlias": "买家登录名",
          "version": "1.2",
          "merchantDomain": "cnsuning.com",
          "submitTime": "提交时间",
          "bizSource": "业务类型",
          "extData": "预留信息",
          "notifyUrl": "服务器异步通知URL",
          "inputCharset": "编码类型",
          "orders": "订单数据集",
          "merchantNo": "03232"
        }
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.retailer.querybtborderpayonlineinfo.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.retailer.querybtborderpayinfo.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.srcdss 服务不可用 请联系苏宁技术人员
biz.retailer.querybtborderpayinfo.invalid-biz:100 请求参数缺失 请检查查询参数
biz.retailer.querybtborderpayinfo.invalid-biz:101 接口执行返回失败 请检查查询参数
biz.retailer.querybtborderpayinfo.invalid-biz:102 查询结果为空 请检查查询参数
biz.retailer.querybtborderpayinfo.invalid-biz:103 系统异常 请联系苏宁技术人员
biz.retailer.querybtborderpayinfo.invalid-biz:105 无效的AppId请求 请检查查询参数
公共异常码
API工具
FAQ