历史接口版本

财务查询功能(旧)

测试环境:http://183.62.66.69:60006/cmb-mser

生产环境:https://pay.cmbchina.com

账务查询是招商银行商户服务平台核心的功能模块,包括:交易订单管理、退款管理、结算管理、对账单下载等。下面将对各功能进行单独介绍。

● 订单查询

商户可通过交易订单管理功能,查询当前和历史交易订单信息,支持按时间范围批量查询和按订单号单笔查询。交易订单信息包含有商户订单时间、商户订单号、订单状态、订单金额、结算金额、优惠金额和其他订单信息。 订单状态分四种,包括:已结账、未结账、未知、失败。已结账指该笔订单已交易成功。未结账是指该笔订单已冻结,通常发生在预授权交易中。 未知是指该笔订单超时或由于网络异常未收到支付结果通知。失败是该笔订单由于账户余额不足、密码错误导致。因此,商户查询时订单状态选已结账即可。

操作路径:商户服务平台-账务查询-交易订单管理

备注:暂不支持查询被动(免密)支付非轮询模式的交易订单,目前商户可通过一网通支付对账单下载查询。

1)交易汇总查询

商户可查询日期跨度在31天内交易总览,包括收款总笔数、总金额,退款总笔数、总金额,交易总净额。

图片12.png

2)交易订单查询查询

商户可查询订单日期在1年范围内的订单信息,单次查询时间跨度不得超过31天,并且可通过订单状态进行筛选。

图片13.png

3)单笔订单查询

商户可查询订单日期在1年范围内的订单信息,查询时需输入订单日期和商户订单号进行查询。

图片14.png

4)多笔订单查询

商户可根据上传模板文件,批量查询多笔订单,单次上传订单数据不能超过1000笔。

图片15.png

5)查看详情

在查询列表里点击详情,可查询订单详情。

3.png


● 申请退款

退款功能可满足商户手工对交易成功订单发起退款。退款申请分为单笔退款和批量退款,支持发起部分退款和全额退款。退款模式分为“按订单金额进行退款”和“按上送金额进行退款”,对于享受优惠交易,退款后“按订单金额”模式正常回退优惠金额,“按上送金额”不回退优惠金额。为保障商户资金安全,可执行退款操作的设备需提前安装操作证书。退款申请提交后,需审核通过后才发起退款。

操作路径:商户服务平台-账务查询-申请退款

备注:暂不支持被动(免密)支付非轮询模式的交易订单申请退款,商户可通过退款API接口实现退款。

1)单笔退款申请

输入订单日期和商户订单号,发起退款申请。

图片1.png

选择“按订单金额进行退款”,退款金额应小于订单剩余可退金额;选择“按上送金额进行退款”,退款金额应小于实扣剩余可退金额

备注:默认请选择“按订单金额进行退款”,“按上送金额进行退款模式”目前需联系总行另行授权开通。

单笔申请退款2.png

2)批量退款申请

图片3.png

批量退款前需下载退款文件模板,一份文件最大支持10000条记录。上传的退款文件包含:商户订单日期、商户订单号、退款金额、备注、退款模式。其中退款模式默认请选择“Auto”或置为空,“Manual”模式目前需联系总行另行授权开通。文件上传后后,待状态显示订单校验成功,再选择退款申请即可。具体可参考以下:

图片4.png

图片5.png


● 退款审核

退款审核是对已发起退款申请的退单进行通过或驳回操作,若退款申请通过则会发起退款请求进行退款。商户审核状态有:已申请退货、已审批退货和已拒绝审批。

操作路径:商户服务平台-账务管理-退款审核

图片6.png


● 退款查询

商户可查询已经审核通过的退款的状态和信息。退款状态有:已直接退款、无效、退款状态未知。已直接退款是指该笔退款已完成。 无效是指该笔退款错误,请检查申请信息是否正确。退款状态未知是指是指该笔申请超时或由于网络异常未收到退款结果通知。

操作路径:商户服务平台-账务管理-退款查询

图片7.png


● 入账汇总查询

招商银行按和商户签订协议中的结算周期和手续费规则给商户进行资金结算后,进入商户资金清算账户的入账汇总查询。单次查询日期最长跨度为31天,入账状态分为成功和失败。 测试环境暂无入账汇总数据,生产环境正常显示。

操作路径:商户服务平台-账务管理-入账汇总查询

备注:暂不支持被动(免密)支付非轮询模式的交易入账汇总查询。

图片8.png


● 对账明细查询

入账明细即当天给商户做清算入账的交易记录,即商户对账单,主要用于商户对账管理。单次查询日期最长跨度为31天。测试环境暂无入账明细数据,生产环境正常显示。

操作路径:商户服务平台-账务管理-入账明细查询

备注:暂不支持被动(免密)支付非轮询模式的交易入账明细查询。

图片9.png


● 一网通对账单下载

除通过查询入账明细API下载对账单外,商户可通过商户服务平台一键导出对账单。对账单的单次查询日期最长跨度为31天,如需查询更长时间跨度,请分批次预约下载。如账单文件状态出现处理失败,请缩短查询日期范围或稍后重试。

操作路径:商户服务平台-账务管理-入账汇总查询

图片10.png

商户对账单的具体字段如下:

交易日期、商户订单号、交易类型、交易金额、结算货币、结算金额、费用金额、优惠金额、结算日期、卡类型、支付方式、附加数据、特殊码。