U付

数据对账(商户平台)

5.10 数据对账(商户平台) 对账对账文件以支付平台对账日期为基准,生成支付平台指定对账日期内所有交易相关记录,故该接口数据可直接用于生成财务结算数据。1个对账文件内可能包含1-2个自然交易日期的交易记录,请商户在与自身平台自然交易日期内所有交易数据核对时注意此情况。 5.10.1 接口地址 http://pay.soopay.net/spay/pay/payservice.do 5.10.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 service 接口名称 变长 32 download_settle_file Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 sign 签名 变长256 参见签名机制 Y 4 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 5 version 版本号 定长3 定值 4.0 Y 业务参数 1 settle_date 对账日期 定长8 商户的对账报表和对账报表均以此日期为准,格式为YYYYMMDD Y 说明:对账数据是每天早上7:00开始生成,于9:00左右生成结束,请各商户于9:00以后获取昨天的对账记录。 5.10.3 请求数据样例 一. 商户请求平台示例:

5.10.4 对账文件内容说明 响应数据说明 对账文件下载时,将以http文件流的形式响应给接口调用者。

平台响应数据格式说明: 平台响应数据为对账文件,供商户下载。 文件格式说明:

  1. 文件头是一行记录,每笔交易对应文件中的一行,每个数据域用<逗号>“,”分割;最后一行是汇总信息
  2. 文件头信息(第一行): TRADEDETAIL-START,商户号(mer_id),对账日期(settle_date),版本号(version),返回码(ret_code),返回信息(ret_msg) [回车换行]
  3. 每笔交易:商户号(mer_id),商品号(goods_id),手机号(mobile_id),订单号(order_id),定单日期(mer_date),支付日期(pay_date),金额(amount),付款类型(amt_type),银行类型(gate_id),对账日期(settle_date),交易类型(trans_type),交易状态(trans_state),银行对账状态(bank_check),支付产品编号(product_id) ,退费流水号(refund_no) , 交易成功时间(trans_time) [回车换行] 文件汇总信息(最后一行):TRADEDETAIL-END,商户号(mer_id),交易日期(settle_date),总笔数,总金额 对账文件字段说明 NO. 字段 名称 说明 1 mer_id 商户号 平台统一分配的商户号 2 goods_id 商品号 商户下单时提交的goods_id 3 mobile_id 手机号码 用户支付时使用的手机号码 4 order_id 订单号 商户下单时提交的order_id 5 mer_date 订单日期 商户下单时提交的mer_date 6 pay_date 支付日期 用户确认支付的日期 7 amount 金额 交易金额,以分为单位 8 amt_type 付款类型 01:人民币 02:移动话费 03:移动积分 9 gate_id 银行类型 网银类交易用户使用的银行 10 settle_date 对账日期 交易的对账日期 11 trans_type 交易类型 01:消费 20:退款 12 trans_state 交易状态 0:初始 1:成功 -1:失败(一般情况下对账文件只出成功交易) 13 bank_check 银行对账状态 0:初始 1:对账成功 -1:对账失败 14 product_id 支付产品编号 联动定义的支付产品 15 refund_no 退款流水 退款交易此字段有值。退款时由商户生成的退款流水 16 trans_time 交易成功时间 最后交易时间

5.10.5 对账文件内容样例 对账文件名称:6374_20130807.txt 文件内容:

TRADEDETAIL-START,6374,20130807,v4.0,0000,生成对账文件成功 6374,2012,15001052294,187236111,20130807,20130807,1,01,12,20130807,01,1,0,P1150000,,153915 6374,12345678,15901357692,839372,20130807,20130807,1,01,12,20130807,01,1,0,P1350000,,154656 6374,1233333,13798208090,2013032118,20130321,20130803,19000,01,12,20130803,20,1,0,P1550000,1308030938028731,182134 6374,444,18600439818,00014658950,20130502,20130803,93800,01,12,20130803,20,1,0,P1550000,1308031906076716,211312 TRADEDETAIL-END,6374,20130807,2,2