交易请求报文

JSON:

  1. {
  2.     "request_type": "bcm_notify_request",
  3.     "isspid": "39493002",
  4.     "system_id": "8888",
  5.     "user_id": "user01",
  6.     "timestamp": "2019-04-01 02:00:00",
  7.     "order_id": "11111111111111111111",
  8.     "trade_status": "1",
  9.     "payment_type": "1",
  10.     "mid": "301310070118940",
  11.     "tid": "99800010",
  12.     "batch_no": "000001",
  13.     "trace_no": "000001",
  14.     "ref_no": "000523823884",
  15.     "card_no": "622262*********9671",
  16.     "trade_amount": "1",
  17.     "trade_time": "2019-08-08 15:15:15",
  18.     "channel": "4",
  19.     "reason": "失败原因",
  20.     "json_detail": "{\"a\":\"111\"}",
  21.     "sign": "79CB18BC49A4D60C457506EA4EF27C14"
  22. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>bcm_notify_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <system_id>8888</system_id>
  6.     <user_id>user01</user_id>
  7.     <timestamp>2019-08-08 15:15:15</timestamp>
  8.     <order_id>11111111111111111111</order_id>
  9.     <trade_status>1</trade_status>
  10.     <payment_type>1</payment_type>
  11.     <mid>301310070118940</mid>
  12.     <tid>99800010</tid>
  13.     <batch_no>000001</batch_no>
  14.     <trace_no>000001</trace_no>
  15.     <ref_no>000523823884</ref_no>
  16.     <card_no>622262*********9671</card_no>
  17.     <trade_amount>1</trade_amount>
  18.     <trade_time>2019-08-08 15:15:15</trade_time>
  19.     <channel>4</channel>
  20.     <reason>手动取消</reason>
  21.     <json_detail><![CDATA[扩展字段(json格式)]]></json_detail>
  22. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：bcm_notify_request必填
isspid商户号String(8)翼码商户号，由翼码提供必填
system_id系统平台号String(4)由翼码提供必填
user_id操作员标识String(20)操作员号可空
timestamp请求时间String(19)发送请求的时间，格式“yyyy-MM-dd HH:mm:ss”必填
order_id订单编号String(32)大于12位小于32位必填
trade_status支付结果String(1)0：支付失败
1：支付成功		必填
payment_type支付方式String(1)1：银行卡必填
mid银联商户号String(64)支付成功时必填可空
tid银联设备号String(8)支付成功时必填可空
batch_no银联批次号String(20)可空
trace_no银联流水号String(20)可空
ref_no银联交易参考号String(20)可空
card_no交易卡号String(20)前6后4明文，中间隐藏可空
trade_amount交易金额String(16)以分为单位
支付成功时必填		可空
trade_time交易时间String(19)格式“yyyy-MM-dd HH:mm:ss”可空
channel交易通道String(1)3：交行POS
4：星POS(翼码APP)
5：通联
传空，默认为3		可空
reason失败原因String(256)交易失败的原因（通道返回的，或者APP主动取消）可空
json_detail通道返回串String(2048)通联为json字符串可空

通联返回的json_detail

参数名称可选注释
BUSINESS_ID必填业务类型
AMOUNT必填金额
DISC_AMOUNT优惠金额
ACTUALLY_AMOUNT实付金额
TRACE_NO必填流水号
ORIG_TRACE_NO原始流水号
EXP_DATE必填有效期
BATCH_NO必填批次号
MERCH_ID必填商户号
MERCH_NAME必填商户名
TER_ID必填终端号
REF_NO必填系统参考号
AUTH_NO必填授权码
REJCODE必填返回码
ISS_NO发卡行号
ISS_NAME必填发卡行名称
CUPS卡组织或钱包机构
CARDNO必填卡号
DATE必填交易日期
TIME必填交易时间
REJCODE_CN必填返回码解释
CARDBACK卡片回收标志
MEMO备注字段
TRANS_CHECK交易唯一标识
CARD_TYPE_IDENTY必填借贷记卡标识(0:借记 1:贷记)
WILD_CARD_SIGN必填内外卡标识(0：内卡 1:外卡)
TRANS_CHANNEL交易渠道
SIGN签名
PRINT_FLAG打印标记
CARDTYPE卡类型
TRANS_TICKET_NO交易单号
OPER_NO操作员号
INSTALLMENT_PERIOD_NUM分期消费分期数
INSTALLMENT_FEE_RATE分期手续费率
INSTALLMENT_CHARGE_WAY分期手续费收取方式
INSTALLMENT_FIRST_AMT首期还款金额
INSTALLMENT_EACH_AMT每期还款金额
INSTALLMENT_CURRENCY分期还款币种
INSTALLMENT_FEE分期手续费
INSTALLMENT_REWARD_POINTS奖励积分
INSTALLMENT_FIRST_FEE首期手续费
INSTALLMENT_EACH_FEE每期手续费
SIGN_FLAG是否电子签名了(0-未签名 1-签名)
USDK_VERSION_CODEUSDK版本号
BUS_INFO扩展字段具体说明见附录一(子商户号和子商户名称)

交易返回报文

JSON:

  1. {
  2.     "response_type": "bcm_notify_response",
  3.     "isspid": "39493002",
  4.     "trans_time": "20181214143957",
  5.     "sys_seq": "0f041092d0ccc6ae",
  6.     "order_id": "11111111111111111111",
  7.     "result": {
  8.         "id": "0000",
  9.         "comment": "通知成功"
  10.     },
  11.     "sign": "79D928004531AE15DFA6AD7E9A6A2447"
  12. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>bcm_notify_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <sys_seq>000000000244</sys_seq>
  6.     <trans_time>20090405010104</trans_time>
  7.     <order_id>11111111111111111111</order_id>
  8.     <result>
  9.         <id>0000</id>
  10.         <comment>通知成功</comment>
  11.     </result>
  12. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：bcm_notify_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
sys_seq随机串号String(16)随机生成串号，仅用于日志跟踪用，不保存必填
trans_time接口返回时间String(14)接口返回时间，格式：yyyyMMddHHmmss必填
order_id订单编号String(32)商户支付订单编号必填
result
->id		响应码String(4)0000-通知成功
9990-通知失败
其它失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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