19PAY捷迅支付在线支付网关接口文档2.00(web版)

1、 19PAY高阳捷迅在线卡兑换平台接口规范2.00（WEB版） 19PAY 捷迅支付在线卡兑换平台接口规范版本号2.00（WEB版）北京高阳捷迅信息技术有限公司版本更新记录：更新时间更新内容修改人2010-10-13防钓鱼参数孙逊目 录1.概要31.1.目的31.2.版权声明31.3.客户服务32.支付接口42.1.接口说明42.2.订单支付类型说明42.3.网上支付业务流程52.4.支付请求62.5.支付请求返回（前台通知）72.6.支付结果服务器端通知(后台通知)92.7.注意事项101. 概要1.1. 目的帮助商户接入 19PAY在线卡兑换平台，快速掌握 19PAY在线卡兑换平台各项功能

2、，便于尽快投入使用。1.2. 版权声明此文档版权归北京高阳捷迅信息技术有限公司所有。作为本系统的最终用户，可以拥有该份文档的使用权，但未征得北京高阳捷迅信息技术有限公司的书面批准，不得向第三方借阅、出让、出版该文档。1.3. 客户服务服务热线：400-019-19992. 支付接口2.1. 接口说明 本接口主要目的是为了让商户系统接入 19PAY捷迅卡兑换平台，能够通过预付费卡、电子钱包等方式快捷的实现电子支付。 请求方式： 商户系统-19PAY捷迅卡兑换平台 商户系统作为请求客户端，按照本接口的约定发送请求，而 19PAY捷迅卡兑换平台监听来自商户系统的请求给予处理，处理完成后返回商户系统。

3、2.2. 订单支付类型说明1）、神州行充值卡 神州行充值卡支付，商户请求信息到19PAY高阳捷迅卡兑换平台，19PAY高阳捷迅网站显示让用户输入神州行缴费卡序列号和密码进行付费的页面。不支持运营商的赠卡详细说明见: /page/pgwpage/help.jsp2）、联通充值卡 联通卡支付，商户请求信息到19PAY高阳捷迅卡兑换平台，19PAY高阳捷迅网站显示让用户输入联通缴费卡卡号和密码进行付费的页面。不支持运营商的赠卡3）、电信充值卡 电信卡支付，商户请求信息到19PAY高阳捷迅卡兑换平台，19PAY高阳捷迅网站显示让用户输入联通缴费卡卡号和密码进行付

4、费的页面。不支持运营商的赠卡2.3. 网上支付业务流程网上支付业务流程步骤说明：1) 消费者登录商户网站，选择支付内容并下单，商户网站产生预定单信息，商户提供商户唯一交易号、订单号、金额等信息；2) 消费者确认支付后，服务商将商户唯一交易号、订单号、支付金额、支付方式、产品名称等信息通过浏览器URL传到19PAY捷迅支付网站；（参考接口2.4）3) 19PAY捷迅支付系统根据商户发送的支付方式自动转到不同的业务后台（联通、银行等）进行支付处理；4) 后台系统网站将处理信息返回到19PAY捷迅支付； 5) 19PAY捷迅支付进行处理后，返回处理结果给消费者；6) 支付系统返回结果给捷迅网关；7)

5、 19PAY捷迅支付通知商户用户已经付费成功，返回相关的定单信息和捷迅交易流水号；（参考接口2.4，2.6）8) 商户收到信息进行验证，为用户提供服务。2.4. 支付请求l 请求方式商户系统 19PAY捷迅卡兑换平台商户系统的支付按钮通过HTTP协议链接到19PAY的接口地址，并按照接口参数定义以post传送相关数据。商户系统的网站页面将转到19PAY捷迅卡兑换平台的网站页面。关于防钓鱼功能，请详细看一下2.7的注意事项l 接口地址测试地址：32/cardpage/bussOrder.do (正试地址另行通知)l 接口参数参数含义长度是否非空备注versio

6、n_id版本号10非空本接口版本号:2.00merchant_id商户代码20非空19PAY统一分配的商户代码verifystring验证摘要串100非空32位小写详见接后描述order_date订单日期8非空格式为YYYYMMDDorder_id商户订单号30非空该订单号由商户系统生成。order_id唯一确定一条订单。amount订单金额8非空单位为元，精确到分,小数点后2位currency货币类型8非空RMB：人民币returl支付请求返回url128非空本接口处理完成后，捷迅平台将重定向到该url。形式为：/result.jsp注意：地址请不要携

7、带任何参数，如 | 和¬ify_url后台通知地址128可空后台通知地址，如果空则以数据库配置为准，如果非空则以商户传入地址为准。注意：地址请不要携带任何参数，如 | 和&pm_id支付方式id20可空用于区分支付通道的类别. 方式id列表另行提供.为空时:支付页面会显示19PAY为商户开通的所有支付方式. 如果不显示某一支付方式，可以赋空串如果要单独显示某一支付方式pm_id要赋值神州行： pm_id=CMJFK联通缴费卡：pm_id=LTJFK电信： pm_id=DXJFKmx_ip支付用户IP非空19pay系统防钓鱼参数商家需将支付用户的IP地址赋值给此参数pc_id支付通道id2

8、0可空如果不显示某一支付方式，可以赋空串。order_pname商品名称20可空显示在19PAY的页面order_pdesc商品描述255可空此参数提交之后在支付结果通知中可能不会再传回给商家，如需要依据请自行进行入库处理user_name订货人姓名10可空同上user_phone用户电话20可空同上user_mobile用户手机号20可空user_email用户EMAIL30可空注意：商家所传参数请不要携带特殊字符，如单引号 双引号 等l 验证方式本接口采用MD5摘要对请求进行确认。验证失败的请求将不予处理。商户首先需要向19PAY在线卡兑换平台申请商户代码（merchant_id）及加密串

9、（merchant_key），并按照以下规则来构造验证摘要串（verifystring）。MD5摘要源串：version_id=%s&merchant_id=%s&order_date=%s&order_id=%s&amount=%s¤cy=%s&returl=%s&pm_id=%s&pc_id=%s&merchant_key=%s以上用于拼写摘要源串的这些参数，请按照协议post到我们的地址，以下同商户以具体的参数值替代以上的%s，并保证顺序及每项的准确性，参数如为空值则直接替代空值即可。得到验证摘要串（verifystring）后作为post数据的一部分发送给接口地址。2.5.

10、 支付请求返回（前台通知）l 请求方式19PAY捷迅卡兑换平台 商户系统119PAY捷迅卡兑换平台以HTTP Post的方式返回returl，并按照接口参数定义post相关数据。l 接口地址returl （该url由商户系统在2.4接口中提供）l 接口参数参数含义是否非空备注version_id版本号非空本接口版本号:2.00merchant_id商户代码非空19PAY统一分配的商户代码verifystring验证摘要串非空32位小写详见接后描述order_date支付请求提交时间可空同2.4的order_dateorder_id商户订单号非空同2.4的order_id amount订单金额非

11、空同2.4的amountcurrency货币类型非空同2.4的currencypay_sq19PAY支付流水号非空pay_date支付时间非空格式为YYYYMMDDHHMMSSpm_id支付方式非空支付方式id列表另行提供。pc_id支付通道非空通道id列表另行提供。pay_cardno卡序列号可空pay_cardpwd卡密码可空result支付结果非空Y：成功以下返回码为正在处理中40008 50010 81008 81012 81029 81030 81033 8103481035 81036 81037 81088 l 验证方式本接口采用MD5摘要对请求进行确认。商户系统对于验证不通过的

12、请求返回将不做处理。19PAY捷迅卡兑换平台按照以下规则来构造验证摘要串（verifystring）。MD5摘要源串：version_id=%s&merchant_id=%s&order_date=%s&order_id=%s&amount=%s¤cy=%s&pay_sq=%s&pay_date=%s&pc_id=%s&result=%s&merchant_key=%s19PAY捷迅卡兑换平台将以具体的参数值替代以上的%s，并保证顺序及每项的准确性，参数如为空值则直接替代空值。19PAY捷迅卡兑换平台得到验证摘要串（verifystring）后作为post数据的一部分发送给接口地址

13、。 商户系统接到请求返回后将按照同样的规则组成MD5摘要源串，得到结果后与参数中的verifystring进行比对来决定下一步操作。2.6. 支付结果服务器端通知(后台通知)l 前置条件 结果通知notify_url：该值由商户直接提供给19PAY技术人员。19PAY卡兑换平台将根据这个url来发送后台服务器端的支付结果通知。 注意：这个notify_url同提交请求参数中的notify_url，如果商家在提交请求中传这个notify_url则以商家传的为准，否则以数据库配置为准。l 请求方式19PAY捷迅卡兑换平台 商户系统19PAY捷迅卡兑换平台以HTTP Post方式发送支付结果通知给n

14、otify_url，商户系统在接收到支付结果后返回结果（Y：成功 N：失败）19PAY捷迅卡兑换平台将在用户完成支付后第一时间发送结果通知，以确保商户能够及时进行下一步处理。如果19PAY捷迅卡兑换平台接收不到返回结果，将按照一定的时间间隔重发(时间间隔计算方法为：时间间隔计算方法为：（n-1）3 分钟 n为重发次数)，直到超过一个限定的次数（目前为50次），19PAY捷迅卡兑换平台则认为商户系统的接口出了问题，将暂停发送。对于已经暂停发送的结果通知，捷迅公司将及时通知商户，商户也可联系客服进行重发或者通过商户专区查询补发。l 接口地址notify_urll 接口参数参数含义是否非空备注ver

15、sion_id版本号非空本接口版本号:2.00merchant_id商户代码非空19PAY统一分配的商户代码verifystring验证摘要串非空32位小写详见接后描述order_date订单日期可空格式为YYYYMMDDorder_id商户订单号非空result支付结果非空Y：成功 F：失败amount金额非空currency币种非空pay_sq支付流水号非空pay_date支付时间非空格式为YYYYMMDDHHMMSSpm_id支付方式非空pc_id支付通道编号非空pay_cardno卡序列号可空Pay_cardpwd卡密码可空l 接口返回商户系统如果对该支付结果确认，则返回Y，否则返回N

16、。如果商户系统收到的结果通知是已经给用户发货，也要返回Y，但是同一订单不要重复发货。返回请不带任何html 等静态标记。l 验证方式请求的MD5验证摘要串由该串产生：version_id=%s&merchant_id=%s&order_id=%s&result=%s&order_date=%s&amount=%s¤cy=%s&pay_sq=%s&pay_date=%s&pc_id=%s&merchant_key=%s2.7 注意事项1. MD5加密结果是32位小写字符串2. 参数verifystring由每个接口里的验证方式中的验证串赋值之后进行MD5加密所得3. order_pd

17、esc、user_name、user_phone、user_mobile、user_email这些参数19pay系统在商家提交之后可能不会再返回，如需要依据，请在提交的时候自行进行入库处理，之后依据订单号查询发货4. 前台通知是通过浏览器发送的，很多原因可能会造成商家接收不到前台通知，所以我们要求商家已后台通知（服务器端）为准5. 前台通知和后台通知中的验证方式是不一样的6. 商家后台收到后台通知，根据支付通知的订单号，先查该订单支付状态，根据支付状态判断是否已经处理i. 如果处理过 则显示 Y ，(19pay 支付系统,在收到显示的Y 后，就不会再重复发通知了，如果超时等)ii. 如果没处理过 ，则完成发货和支付状态的修改 显示 Y ， (19pay 支付系统,在收到显示的Y 后，就不会再重复发通知了，如果超时等)7、在结算时，以章节2.6中的pay_date时间为准 8、订单号不能重复9