文档介绍：C2C信用支付接口
商户手册
中国工商银行软件开发中心
Copyright Reserved
文档属性
文档属性
内容
文档名称:
网上银行系统C2C信用支付接口商户手册
文档版本号:
文档状态:
正式稿
文档编写完成日期
2007-7-12
文档变更历史清单
文档版本号
变更日期
修改人
变更内容简述
2007-7-12
曾凯
增加描述xml头;
通知消息方式;
2009-1-21
魏阁麟
“要延长的有效期长度”字段的描述说明
第 1 章 业务说明 3
第 2 章 商户接口 5
买家预支付 6
买家提前支付 10
超期商户支付 12
商户延期支付到期日 13
买家退款申请、撤消、确认、仲裁申请、撤消、确认 15
商户单笔订单查询 17
通知消息及查询返回 18
其他 22
第 3 章 商户开发 22
业务说明
买家在商户网站进行C2C信用购物交易,工行完成买家、卖家、商户手续费的资金转账。信用支付的主要作用是,银行建立中间中转账户,买家支付的资金并不直接转付给卖家,而是先转付到银行的中间账户上,此笔从买家账户到银行中间账户的转账称为预支付;预支付后,商户应通知卖家进行发货处理,买家在接收到货物后确认,如果没有问题则在商户发起确认支付,此时将保留在银行中间账户的资金转付到卖家账户和商户手续费账户。如果买家对于货物存有异议,可以申请部分、全部、当日、隔日的退货处理,当提起申请退货处理后,此时的订单等待卖家进行退货确认,如果卖家允许退货,则在商户发起退货确认,银行将保留在中间账户的资金,部分或者全部的转回买家账户。如果卖家不同意退货,则可以在商户网站拒绝退货,此时订单资金将恢复为保留状态。买家仍可提出申请仲裁,此时银行等待仲裁机构对此笔交易的仲裁确认,如果仲裁机构同意退货,则通知银行,银行将保留在中间账户的资金转回买家账户,如果仲裁机构不同意退货,则恢复订单资金的保留状态。
每一笔信用支付的订单设置一个订单有效期。1、在有效期内,买家可以提出申请退货、申请仲裁处理;提出申请后,需卖家确认,系统会累加卖家确认时间到买家申请时间的时差到订单有效期上,保证买家有足够的控制订单的时长。卖家不确认,此笔资金也不能转到卖家账户;2、如果卖家发货后,买家收到货物,没有及时进行支付确认,则在订单超过订单有效期后,商户可以发起超期支付请求,此时银行将在中间账户保留的订单资金转付到卖家账户和商户手续费账户。
对于订单有效期,商户有延长的权限,银行提供延长支付到期日接口,商户调用此接口,可以延长原订单提交时设置的到期日,但是不能缩短到期日。
对于买家,如果提出了退货申请、仲裁申请,在卖家没有确认前,有权撤销处理,即撤销退货、撤销仲裁。撤销之后,订单资金恢复为保留状态,等待买家确认支付,或者由商户超期支付。
业务特色:如果在预支付接口中,商户上送了买家和卖家的手机号码,本订单在最终的确认支付或者超期支付,即资金成功清算后,会自动向买家、卖家发送短信通知。
为了方便买家处理,在工行的个人网银提供信用支付指令的查询,并提供针对此订单提出退货申请和仲裁申请的功能,如果买家在工行个人网银提起申请,在申请接受后,银行会主动发送商户通知,让商户记录的订单状态与银行同步。
为了方便商户处理,在工行的商户服务页面,提供对于信用支付指令的查询,以及对于申请退款的订单,提供向买家退款功能;对于超期订单,提供向卖家支付功能;当商户员工在工行商户服务页面完成资金处理后,银行会主动发送商户通知,让商户记录的订单状态与银行同步。
由于采用HTTP协议进行商户的通知,HTTP连接的不可靠性造成会有掉单的情况,提供C2C信用支付查询接口,商户可以调用此接口来同步商户和银行之间的订单状态。
允许买家申请部分退货,部分退货可以发起多次,但是退货总额不能超过订单总金额。商户可以在商户服务页面查询一笔订单对应的多笔退货记录。
资金流向图:
银行端订单状态图:
注:
等待银行资金监管、等待银行清算、退款处理中、仲裁处理中,4个状态为银行处理时的中间状态,在这些状态时,不接收商户或买家发起新的申请。
对于处于交易失败、清算失败的订单,商户仍可重新提交,最终实现订单的提交和资金清算,如果多次尝试不成功,需检查自身程序和系统运行情况,或者与工行联系。
“资金银行监管中”即上文描述的订单资金保留状态。
所有银行端的状态变化,会根据此图判断现有状态,是否允许处理,然后到下一个状态。
C2C信用支付交易中,银行提供了多个商户接口,具体内容见下章。这些接口中只有两个需要买家参与,并且有银行和