本接口已停止维护,仅限存量客户使用,新客户更换 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值的正确性。

交易请求报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <PayNotifyReq version="1.0">
  3. <ISSPID>39493002</ISSPID>
  4. <OutTradeNo>1000000000000001</OutTradeNo>
  5. <TradeNo>2016041421001004700252389973</TradeNo>
  6. <PayType>502</PayType>
  7. <TransType>1</TransType>
  8. <Status>1</Status>
  9. <TxAmt>10</TxAmt>
  10. <BussDiscountAmt>1</BussDiscountAmt>
  11. <PlatformDiscountAmt>1</PlatformDiscountAmt>
  12. <TransTime>20180620102350</TransTime>
  13. <ChargeAmount>0</ChargeAmount>
  14. <BuyerPayAmount>1</BuyerPayAmount>
  15. <ReceiptAmount>1</ReceiptAmount>
  16. <PartnerID>2088111111111111</PartnerID>
  17. <StoreID>1111111111</StoreID>
  18. </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)商户自定义门店编号可空

标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!

交易返回报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <PayNotifyRes>
  3. <Status>
  4. <StatusCode>0000</StatusCode>
  5. <StatusText>success</StatusText>
  6. </Status>
  7. </PayNotifyRes>

交易返回报文说明

节点名称中文名称类型说明是否必填
Status
->StatusCode
返回码String(4)0000 – 接收成功
如接收成功请返回“0000”,否则翼码会继续重发
必填
Status
->StatusText
返回信息String(100)若回传中文需使用GBK字符编码可空