业务说明
本接口请求方为翼码系统,接收方为商家系统。
支持的交易类型:4.23微信小程序支付
以上交易类型支付成功后,通知商户系统支付结果。
报文格式:xml=XML报文&mac=md5(接入密钥+XML报文+接入密钥)
请求方式:POST
Content-Type: text/xml;charset=gbk
签名校验mac计算规则为:“接入密钥”拼接“xml报文”拼接“接入密钥”成待签字符串后进行md5计算,32位结果转为大写,详见:XML格式签名计算。
注意:标准接口通知报文节点后续会根据需求而做新增,切勿以固定格式解析报文,避免增加节点造成代码报错;校验mac值时务必取请求的原xml串来进行校验mac值的正确性。
注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。
注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。
交易请求报文
<?xml version="1.0" encoding="GBK"?>
<PayNotifyReq>
<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) | 515:微信小程序 | 必填 |
TransType | 交易类型 | String(1) | 1:支付 | 必填 |
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) | 商户自定义门店编号 | 可空 |
标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!
返回报文
success
返回报文说明
固定字符串“success”表示接收处理成功,其他表示失败。