首信易支付(v4.3)接口说明

《首信易支付(v4.3)接口说明》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、首都易支付（v4.3）平台说明文件首信易支付（v4.3）接口说明（首信易支付商户后台管理系统http://pay.beijing.com.cn）首信易支付流程及功能简要介绍首信易支付网上支付主要流程大致分为商户交易订单提交过程和银行订单确认这两个部分。首先，当消费者在商户处完成购物过程，在商户端服务器形成最终订单（订单参数格式见文档第一部分“商户提交待付款订单接口”说明）且消费者选择首信易支付方式时，该接口程序将消费者订单中有关支付的信息引导到首信易支付平台，消费者在该平台选择银行进行网上支付交易。当交

2、易完成后，首信易支付平台可以通过两种方式通知商户银行对该笔订单的确认消息，商户根据实际业务需要选择这两种方式（其中任一种或者全部）编写相应的程序来接收银行返回的相关支付确认参数，通过对参数的判断来进行后续的业务操作。1．前台页面链接方式：这种方式接收的参数格式见文档第二部分“首信易支付订单支付结果页面返回接口”说明，是将此次支付订单的交易结果（参数）以页面连接的形式发送给商户。这里的前台指这个参数传递过程对持卡消费者是可见的。这种方式的特点是：返回参数的实时性好。但有个别几种支付方式不支持这种方式，有诸

3、如网络中断或者持卡消费者不按要求操作等情况出现时，这种方式会有漏单（银行支付确认消息商户收不到）的现象。一旦出现漏单的情况，商户只能通过后台接口程序方式接收银行订单支付确认消息，或者登录到首信易支付商户后台管理系统查询确认。注意：这种方式接收程序的地址由商户在提交订单时参数v_url的值来指定，无需事先通知首信易支付平台，如有变更只需要在提交订单参数时修改v_url的值即可。2．后台接口程序方式：这种方式接收的参数格式见文档第三部分“首信易支付订单支付结果后台返回接口”说明，是由首信易支付平台转发银行支

4、付确认信息。这种方式是首信易支付平台服务器与商户服务器之间进行通信的，对于持卡消费者是不可见的。这种方式的特点是：支持平台上所有的支付方式，而且在与商户的通信过程中如有网络故障，此方式支持自动重发功能（在首次发送的24小时内）。注意：这种方式接收程序的地址需要由商户来确定，在商户号开通时所填写的初始单中，填写在“订单支付确认返回地址”一栏，并由首信易支付平台管理员按照初始单内容进行开通。开通后如有修改，需要事先通知管理员确认修改。最后，首信易支付将根据交易金额通知银行转帐。通常情况下，首信易支付结算中心

5、会在周一、周四进行转帐工作，但需要满足本地商户本次转帐金额达到两百元人民币、外埠商户本次转帐金额达到六百元人民币的条件。如果不满足上述金额则累计到下次转帐时一起完成。在一旦转帐成功，将立即通知商户转帐结果，通知接口的参数格式为文档第四部分“首信易支付通知商户转帐结果接口”说明。此接口地址由商户确认，填写在初始单中“转帐确认通知接口”一栏中。商户开通后，如果需要更改也要事先通知管理员确认后修改。注意：通知商户转帐过程与网上支付交易是两个相对独立的过程，转帐工作是由首信易支付结算中心工作人员线下完成的，在通

6、知银行进行转帐工作后，会通过“首信易支付通知商户转帐结果接口”12首都易支付（v4.3）平台说明文件将本次转帐的所有订单号发给商户。由于这个接口发送的信息只是起到通知作用，不会影响商户的实际转帐工作。因此商户可以根据自己的实际需要选择是否使用这个接口。（本接口可选）各接口的具体格式如下：一、商户提交待付款订单接口（商户＝＝>>首信易支付）用途：用来接收商户发来的订单信息1、CGI程序接口

7、payment.checkit">2、FORM表单参数说明1．商户编号(v_mid)说明：不可为空值，以初始单上所填商户编号为准。2．订单编号(v_oid)说明：不可为空值，首信易支付订单编号格式统一为：订单生成日期(yyyymmdd)-商户编号-商户流水号例如：19990720-888-12345。商户流水号为数字，每日内不重复即可。注：订单编号所有字符总和不可超过64位，否则首信易支付平台拒绝接受。3．收货人姓名(v_rcvname)说明：不可为空值，统一用商户编号的值代替。4．收货人地址(v_rc

8、vaddr)说明：不可为空值，总长不超过128个字符。5．收货人电话(v_rcvtel)说明：不可为空值，总长不超过32个字符。6．收货人邮政编码(v_rcvpost)说明：不可为空值，总长不超过12个字符。7．订单总金额(v_amount)说明：不可为空值，单位：元，小数点后保留两位，如13.458．订单产生日期(v_ymd)说明：不可为空值，长度为8位，格式为yyyymmdd9．配货状态(v_orderstatus)说明：商户配货状态，