业务说明

本接口请求方为翼码系统,接收方为商家系统。

支持的交易类型:
4.3扫码支付、4.13jsapi支付、4.14微信小程序支付、4.21聚合动态码支付、4.34网银支付、4.65快捷支付申请、4.67快捷支付页面版、4.15银行卡刷卡下单、4.22小程序支付收银台下单

以上交易类型支付成功后,通知商户系统支付结果。

报文格式:JSON

请求方式:POST

Content-Type: application/json;charset=utf-8

签名sign计算规则详见:JSON格式签名计算

注意:标准接口通知报文节点后续会根据需求而做新增,切勿以固定格式解析报文和验签,避免增加节点造成代码报错。

注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。

注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。

注意:可空节点数据为空时,既可能返回null也可能返回空字符串,请解析时注意兼容。

请求报文

  1. {
  2. "isspid": "00026713",
  3. "store_id": "S20220927",
  4. "pos_seq": "C20220928X1000000015",
  5. "source": "1",
  6. "pos_id": "S20220927",
  7. "pay_type": "503",
  8. "trans_type": "1",
  9. "memo": null,
  10. "status": "1",
  11. "tx_amt": "1",
  12. "partner_id": "1503490901",
  13. "end_time": "20220928144502",
  14. "buyer_id": "oXI_E5KN-FJi1Hf65mWeiBF8fUlU",
  15. "mid": "",
  16. "tid": "",
  17. "batch_no": "",
  18. "trace_no": "",
  19. "ref_no": "",
  20. "is_foreign_card": "",
  21. "trade_no": "4200001546202209282282722088",
  22. "buss_discount_amt": "0",
  23. "platform_discount_amt": "0",
  24. "charge_amount": "0",
  25. "user_yima_id": "1111111111",
  26. "atu_trade_no": "4200001546202209282282722088",
  27. "atu_out_trade_no": "C20220928X1000000015",
  28. "bank_code": "",
  29. "sign": "7A6B20F1AC3F18FBFC56F4A36CE3207F"
  30. }

请求报文说明

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

节点名称中文名称类型说明是否必填
sign签名String(32)计算签名方式请看2.1章节必填
isspid商户号String(8)交易的翼码商户号必填
store_id门店号String(20)商户自定义的门店号必填
pos_seq支付请求流水号String(32)请求支付类接口的流水号(pos_seq)必填
source订单来源String(1)1:接口接入
2:收款码牌
必填
pos_id终端号String(20)source=1时,商户自定义终端号
source=2时,收款码编号
必填
pay_type支付方式String(3)502:支付宝
503:微信支付
515:微信小程序
512:银联二维码
516:数字人民币
517:网银支付
518:快捷支付
521:聚分期
620:银行卡刷卡
必填
trans_type交易类型String(1)1:支付必填
memo订单备注String(128)可空
status交易状态String(1)1:成功
0:失败
必填
tx_amt交易金额Number(9)单位为分必填
partner_id商户收款帐号String(64)支付宝PID/微信商户号/间联通道商户号可空
end_time交易完成时间String(14)格式:YYYYMMDDHH24MISS可空
buyer_id买家标识String(128)支付宝:用户登录帐号(带星号脱敏)
微信/微信小程序:用户open_id
银联二维码:银行卡号(带星号脱敏)
网银支付:银行卡号(带星号脱敏)
快捷支付:银行卡号(带星号脱敏)
银行卡刷卡:银行卡号(带星号脱敏)
该字段是否有值取决于支付通道是否返回
可空
mid银联商户号String(64)仅银行卡刷卡类型(pay_type=620),成功时有值可空
tid银联设备号String(8)仅银行卡刷卡类型(pay_type=620),成功时有值可空
batch_no银联批次号String(20)仅银行卡刷卡类型(pay_type=620),成功时有值可空
trace_no银联流水号String(20)仅银行卡刷卡类型(pay_type=620),成功时有值可空
ref_no银联交易参考号String(20)仅银行卡刷卡类型(pay_type=620),成功时有值可空
is_foreign_card外卡标识String(1)0:不是外卡
1:是外卡
仅银行卡刷卡类型(pay_type=620),成功时有值
可空
trade_no支付平台订单号String(64)支付平台的订单号,仅成功时有值可空
buss_discount_amt商家优惠金额Number(9)单位为分,仅成功时有值可空
platform_discount_amt平台优惠金额Number(9)单位为分,仅成功时有值可空
charge_amount手续费Number(9)单位为分,仅成功时有值可空
user_yima_id用户号String(32)仅快捷支付(pay_type=518),成功时有值可空
atu_trade_noATU订单号String(64)支付宝/微信/银联订单号
客户手机支付凭证上的订单号
可空
atu_out_trade_noATU商户订单号String(64)支付宝/微信/银联商户订单号
客户手机支付凭证上的商户订单号
可空
bank_code发卡行编码String(20)该字段是否有值取决于支付通道是否返回可空

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

返回报文

success

返回报文说明

固定字符串“success”表示接收处理成功,其他表示失败。