首信易支付(v4.3)接口说明_20090907
- 格式：doc
- 大小：166.00 KB
- 文档页数：12
首都易支付（v4.3）平台说明文件 1 首信易支付（v4.3）接口说明 （首信易支付商户后台管理系统 http://pay.beijing.com.cn） 首信易支付流程及功能简要介绍 首信易支付网上支付主要流程大致分为商户交易订单提交过程和银行订单确认这两个部分。首先，当消费者在商户处完成购物过程，在商户端服务器形成最终订单（订单参数格式见文档第一部分“商户提交待付款订单接口”说明）且消费者选择首信易支付方式时，该接口程序将消费者订单中有关支付的信息引导到首信易支付平台，消费者在该平台选择银行进行网上支付交易。
当交易完成后，首信易支付平台可以通过两种方式通知商户银行对该笔订单的确认消息，商户根据实际业务需要选择这两种方式（其中任一种或者全部）编写相应的程序来接收银行返回的相关支付确认参数，通过对参数的判断来进行后续的业务操作。 1． 前台页面链接方式：这种方式接收的参数格式见文档第二部分“首信易支付订单支付结果页面返回接口”说明，是将此次支付订单的交易结果（参数）以页面连接的形式发送给商户。这里的前台指这个参数传递过程对持卡消费者是可见的。 这种方式的特点是：返回参数的实时性好。但有个别几种支付方式不支持这种方式，有诸如网络中断或者持卡消费者不按要求操作等情况出现时，这种方式会有漏单（银行支付确认消息商户收不到）的现象。一旦出现漏单的情况，商户只能通过后台接口程序方式接收银行订单支付确认消息，或者登录到首信易支付商户后台管理系统查询确认。 注意：这种方式接收程序的地址由商户在提交订单时参数v_url的值来指定，无需事先通知首信易支付平台，如有变更只需要在提交订单参数时修改v_url的值即可。 2． 后台接口程序方式：这种方式接收的参数格式见文档第三部分“首信易支付订单支付结果后台返回接口”说明，是由首信易支付平台转发银行支付确认信息。这种方式是首信易支付平台服务器与商户服务器之间进行通信的，对于持卡消费者是不可见的。 这种方式的特点是：支持平台上所有的支付方式，而且在与商户的通信过程中如有网络故障，此方式支持自动重发功能（在首次发送的24小时内）。 注意：这种方式接收程序的地址需要由商户来确定，在商户号开通时所填写的初始单中，填写在“订单支付确认返回地址”一栏，并由首信易支付平台管理员按照初始单内容进行开通。开通后如有修改，需要事先通知管理员确认修改。
首信易支付转账成功，将立即通知商户转帐结果，通知接口的参数格式为文档第四部分“首信易支付通知商户转帐结果接口”说明。此接口地址由商户确认，填写在初始单中“转帐确认通知接口”一栏中。商户开通后，如果需要更改也要事先通知管理员确认后修改。 注意：通知商户转帐过程与网上支付交易是两个相对独立的过程，转帐工作是由首信易支付结算中心工作人员线下完成的，在通知银行进行转帐工作后，会通过“首信易支付通知商户转帐结果接口”将本次转帐的所有订单号发给商户。由于这个接口发送的信息只是起到通知作用，不会影响商户的实际转帐工作。因此商户可以根据自己的实际需要选择是否使用这个接口。（本接口可选） 各接口的具体格式如下：
一、商户提交待付款订单接口（商户＝＝>>首信易支付） 首都易支付（v4.3）平台说明文件 2 用途：用来接收商户发来的订单信息 1、 CGI程序接口
2、 FORM表单参数说明 1． 商户编号(v_mid) 说明：不可为空值，以初始单上所填商户编号为准。 2． 订单编号(v_oid) 说明：不可为空值，首信易支付订单编号格式统一为： 订单生成日期(yyyymmdd)-商户编号-商户流水号 例如：19990720-888-12345。商户流水号为数字，每日内不重复即可。商户流水号部分不能包括除数字、英文字母和“-”外其它字符。 注：订单编号所有字符总和不可超过64位，否则首信易支付平台拒绝接受。 3． 收货人姓名(v_rcvname) 说明：不可为空值，统一用商户编号的值代替。 4． 收货人地址(v_rcvaddr) 说明：不可为空值，总长不超过128个字符，统一用商户编号的值代替。 5． 收货人电话(v_rcvtel) 说明：不可为空值，总长不超过32个字符，统一用商户编号的值代替。 6． 收货人邮政编码(v_rcvpost) 说明：不可为空值，总长不超过10个字符，统一用商户编号的值代替。 7． 订单总金额(v_amount) 说明：不可为空值，单位：元，小数点后保留两位，如13.45 8． 订单产生日期(v_ymd) 说明：不可为空值，长度为8位，格式为yyyymmdd 9． 配货状态(v_orderstatus) 说明：商户配货状态，0为未配齐，1为已配齐 10．订货人姓名(v_ordername) 说明：总长不超过64个字符，统一用商户编号的值代替。 11．支付币种(v_moneytype) 说明：0为人民币，1为美元，2为欧元，3为英镑，4为日元，5为韩元 12．返回商户页面地址(v_url) 说明：为消费者完成购物后返回的商户页面，此地址为页面连接方式的返回地址，在此地址放置接收程序用于接收银行返回的支付确认消息（参数格式参照文档第二部分首信易支付订单支付结果页面返回接口）。URL参数是以http://开头的完整URL地址。 13．订单数字指纹(v_md5info) 详情见md5说明 注：以上参数值中不能包含以下特殊字符’”&<>()
3、示例（注：此例商户号888应改为您的商户号）
由于采用HTML表单方式传递参数，就出现了消费者可以任意篡改页面信息的问题，为防止此类现象发生，我们需要对页面部分敏感信息作签名以保证其真实性和完整性。 首信易支付平台向入驻商户提供了一个标准的签名程序源码，该程序提供签名功能，主功能函数为char* hmac (char* text, char* key)，该函数有两个入口参数：char* text和char* key。其中text是将表单中部分敏感信息拼串的结果，具体做法如下： 当消费者在商户端生成最终订单的时候，将订单中的v_moneytype v_ymd v_amount v_rcvname v_oid v_mid v_url七个参数的value值拼成一个无间隔的字符串(char型，顺序不要改变)。而另一个入口参数key则是首信易支付与商户私下约定的密钥。该密钥由商户生成，建议为16个字符，字母数字的组合。并通知首信易支付相关人员。请以电子邮件方式按照：公司名、商户号、联系人、密钥的顺序发送到huangyi@payeasenet.com 该密钥初始值为test，以下所用到的密钥均为此密钥。例如上例表单的拼串结果应为： 01999072013.4588819990720-888-000001234888http://domain/program 该函数返回值即为我们所需的数字指纹，将其写入v_md5info字段即可。
注：为了满足不同商户需要，首信易支付还提供以下几种快捷支付通道，相关支付通道CGI接口链接地址及说明： 英文支付通道：（四种外卡）可使用如下CGI接口链接（form表单参数与前面相同）：
