首信易支付(v4.3).doc

首信易支付（v4.3）接口说明（外卡） （首信易支付商户后台管理系统 ） 首信易支付流程及功能简要介绍 首信易支付网上支付主要流程大致分为商户交易订单提交过程和银行订单确认这两个部分。首先，当消费者在商户处完成购物过程，在商户端服务器形成最终订单（订单参数格式见文档第一部分“商户提交待付款订单接口”说明）且消费者选择首信易支付方式时，该接口程序将消费者订单中有关支付的信息引导到首信易支付平台，消费者在该平台选择银行进行网上支付交易。 当交易完成后，首信易支付平台可以通过两种方式通知商户银行对该笔订单的确认消息，商户根据实际业务需要选择这两种方式（其中任一种或者全部）编写相应的程序来接收银行返回的相关支付确认参数，通过对参数的判断来进行后续的业务操作。 前台页面链接方式：这种方式接收的参数格式见文档第二部分“首信易支付订单支付结果页面返回接口”说明，是将此次支付订单的交易结果（参数）以页面连接的形式发送给商户。这里的前台指这个参数传递过程对持卡消费者是可见的。 这种方式的特点是：返回参数的实时性好。但有个别几种支付方式不支持这种方式，有诸如网络中断或者持卡消费者不按要求操作等情况出现时，这种方式会有漏单（银行支付确认消息商户收不到）的现象。一旦出现漏单的情况，商户只能通过后台接口程序方式接收银行订单支付确认消息，或者登录到首信易支付商户后台管理系统查询确认。 注意：这种方式接收程序的地址由商户在提交订单时参数v_url的值来指定，无需事先通知首信易支付平台，如有变更只需要在提交订单参数时修改v_url的值即可。 后台接口程序方式：这种方式接收的参数格式见文档第三部分“首信易支付订单支付结果后台返回接口”说明，是由首信易支付平台转发银行支付确认信息。这种方式是首信易支付平台服务器与商户服务器之间进行通信的，对于持卡消费者是不可见的。 这种方式的特点是：支持平台上所有的支付方式，而且在与商户的通信过程中如有网络故障，此方式支持自动重发功能（在首次发送的24小时内）。 注意：这种方式接收程序的地址需要由商户来确定，在商户号开通时所填写的初始单中，填写在“订单支付确认返回地址”一栏，并由首信易支付平台管理员按照初始单内容进行开通。开通后如有修改，需要事先通知管理员确认修改。 首信易支付转账成功，将立即通知商户转账结果，通知接口的参数格式为文档第四部分“首信易支付通知商户转帐结果接口”说明。此接口地址由商户确认，填写在初始单中“转账确认通知接口”一栏中。商户开通后，如果需要更改也要事先通知管理员确认后修改。 注意：通知商户转账过程与网上支付交易是两个相对独立的过程，转账工作是由首信易支付结算中心工作人员线下完成的，在通知银行进行转账工作后，会通过“首信易支付通知商户转帐结果接口”将本次转账的所有订单号发给商户。由于这个接口发送的信息只是起到通知作用，不会影响商户的实际转账工作。因此商户可以根据自己的实际需要选择是否使用这个接口。（本接口可选做） 各接口的具体格式如下： 一、商户提交待付款订单接口（商户＝＝首信易支付；必做接口） 用途：用来接收商户发来的订单信息 CGI程序接口（标准提交接口） 英文支付通道：（国际卡业务客户使用）可使用如下CGI接口链接（form表单参数与前面相同）： form name=form method=post action=/prs/e_user_payment.checkit 或 form name=form method=post action=/prs/e_user_payment.checkit 多语言支付通道： form name=form method=post action= /customer/i18n/i18n_raw_order3_0.jsp 注意：使用此通道时，请在下述表单基础上增加如下参数： v_language 页面语言，可选参数编码如下： tw-繁体中文 zh-简体中文 es-西班牙语 en-英文 de-德语 fr-法语 ko-韩语 ja-日语 例：v_language=en 提交到英文页面 FORM表单参数说明 1． 商户编号(v_mid) 说明：不可为空值，以初始单上所填商户编号为准。 2． 订单编号(v_oid) 说明：不可为空值，首信易支付订单编号格式统一为： 订单生成日期(yyyymmdd)-商户编号-商户流水号 例如888-12345。商户流水号为数字，每日内不重复即可。商户流水号部分不能包括除数字、英文字母和“-”外其它字符。流水号可为一组也可以用“-”间隔成几组。但是：订单编号所有字符总和不可超过64位