本接口已停止维护,请更换 4.32 接口对接
本接口请求方为翼码系统,接收方为商家系统。(详情请看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:微信小程序 | 必填 |
| 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字符编码 | 可空 |


