本接口已停止维护,仅限存量客户使用,新客户更换 4.20 接口对接
本接口请求方为翼码系统,接收方为商家系统。(详情请看3.19.1交易说明)
请求报文为:xml=XML报文&mac=md5(接入密钥+XML报文+接入密钥)
请求方式:POST
Content-Type: text/xml;charset=gb2312
签名校验mac计算规则为:“接入密钥”拼接“xml报文”拼接“接入密钥”成待签字符串后进行md5计算,32位结果转为大写,详见:XML格式签名计算。
注意:标准接口通知报文节点后续会根据需求而做新增,切勿以固定格式解析报文,避免增加节点造成代码报错;校验mac值时务必取请求的原xml串来进行校验mac值的正确性。
交易请求报文
<?xml version="1.0" encoding="GBK"?>
<PayNotifyReq version="1.0">
<ISSPID>39493002</ISSPID>
<OutTradeNo>1000000000000001</OutTradeNo>
<TradeNo>2016041421001004700252389973</TradeNo>
<PayType>502</PayType>
<TransType>1</TransType>
<Status>1</Status>
<TxAmt>10</TxAmt>
<BussDiscountAmt>1</BussDiscountAmt>
<PlatformDiscountAmt>1</PlatformDiscountAmt>
<TransTime>20180620102350</TransTime>
<ChargeAmount>0</ChargeAmount>
<BuyerPayAmount>1</BuyerPayAmount>
<ReceiptAmount>1</ReceiptAmount>
<PartnerID>2088111111111111</PartnerID>
<StoreID>1111111111</StoreID>
</PayNotifyReq>
交易请求报文说明
标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
ISSPID | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
OutTradeNo | 商户订单号 | String(32) | 商户订单号,一般为支付/退款接口的请求流水(pos_seq) | 必填 |
TradeNo | 支付平台订单号 | String(64) | 支付平台的订单号,仅成功时返回 | 可空 |
PayType | 支付类型 | String(3) | 502:支付宝支付 503:微信支付 515:微信小程序 512:银联二维码 516:数字人民币 | 必填 |
TransType | 交易类型 | String(1) | 1:支付 2:退款/撤销 | 必填 |
Status | 交易状态 | String(1) | 1:成功 0:失败 | 必填 |
TxAmt | 交易金额 | Number(16) | 单位为分 | 必填 |
BussDiscountAmt | 商家优惠金额 | Number(16) | 商家优惠金额,单位为分,仅支付成功时返回 | 可空 |
PlatformDiscountAmt | 平台优惠金额 | Number(16) | 平台优惠金额,单位为分,仅支付成功时返回 | 可空 |
TransTime | 支付完成时间 | String(14) | 格式:YYYYMMDDHH24MISS | 可空 |
ChargeAmount | 手续费 | Number(16) | 单位为分,仅支付成功时返回 | 可空 |
BuyerPayAmount | 买家付款金额 | Number(16) | 单位为分,仅支付成功时返回 | 可空 |
ReceiptAmount | 实收金额 | Number(16) | 单位为分,仅支付成功时返回 | 可空 |
PartnerID | 收款帐号 | String(64) | 收款帐号,支付宝商户号或微信商户号 | 可空 |
StoreID | 自定义门店号 | String(20) | 商户自定义门店编号 | 可空 |
标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!
交易返回报文
<?xml version="1.0" encoding="GBK"?>
<PayNotifyRes>
<Status>
<StatusCode>0000</StatusCode>
<StatusText>success</StatusText>
</Status>
</PayNotifyRes>
交易返回报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
Status ->StatusCode | 返回码 | String(4) | 0000 – 接收成功 如接收成功请返回“0000”,否则翼码会继续重发 | 必填 |
Status ->StatusText | 返回信息 | String(100) | 若回传中文需使用GBK字符编码 | 可空 |