第五章 19pay捷迅支付商户直联接口规范2.01(卡实际金额).docVIP

19PAY 捷迅支付商户 直联接口规范 版本号3.00 北京高阳捷迅信息技术有限公司（19PAY） 最后修改2009年11月01日  目 录 1. 概要 2 1.1目的 2 1.2版权声明 2 1.3客户服务 2 2. 支付接口 3 2.1 接口说明 3 2.2订单支付类型说明 3 2.3 网上支付业务流程 3 2.4 支付通道查询 4 2.5 支付请求 5 2.6支付结果服务器端通知(后台通知) 7 2.7注意事项 8 2.8 返回码列表9 概要 1.1目的 帮助商户接入 19PAY 支付平台，快速掌握 19PAY支付平台各项功能，便于尽快投入使用。 1.2版权声明 此文档版权归所有作为本系统的最终用户，可以拥有该份文档的使用权，但未征得的书面批准，不得向第三方借阅、出让、出版该文档。支付接口 2.1 接口说明 本接口主要目的是为了让商户系统接入 19PAY 支付平台，能够通过预付费卡等方式快捷的实现电子支付。 请求方式： 商户系统→19PAY支付平台 商户系统作为请求客户端，按照本接口的约定发送请求，而19PAY支付平台监听来自商户系统的请求给予处理，处理完成后返回商户系统，同时提供查询接口。 2.2订单支付类型说明 神州行充值卡 神州行充值卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅支付网关，高阳捷迅支付网关进行处理 联通充值卡 联通卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅支付网关，高阳捷迅支付网关进行处理 电信充值卡 电信充值卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅支付网关，高阳捷迅支付网关进行处理 ■ 详细说明见: /page/pgwpage/help.jsp 2.3 网上支付业务流程 网上支付业务流程步骤说明： 用户登录商户网站，选择商品、输入充值卡卡号、密码等支付信息，商户网站产生预定单信息，包括商户唯一交易号、订单号、金额、充值卡号及充值卡密码等信息； 用户确认支付后，服务商将商户唯一交易号、订单号、支付金额、支付方式、产品名称等信息发送到高阳捷迅支付网关；（参考接口2.5） 高阳捷迅系统根据商户发送的支付方式自动转到不同的支付系统（神州行、联通等）进行支付处理； 各支付系统将处理信息返回到高阳捷迅支付网关； 高阳捷迅支付网关进行处理后，返回处理结果及相关的订单信息和捷迅交易流水号给商户服务器；（参考接口2.6） 商户收到信息进行验证，为用户提供服务。 2.4 支付通道查询 请求方式 商户系统 →19PAY支付网关 商户系统以HTTP Post的方式请求19PAY的接口地址，并按照接口参数定义传送数据。19PAY支付网关将以html方式返回查询结果。 接口地址 测试环境 08/card/channel.jsp 接口参数 参数 含义 长度 是否非空 备注 merchant_id 商户代码 20 非空 19PAY统一分配的商户代码 接口返回 返回所有支付通道的四个相关属性组成的字符串：支付通道编码（pc_id），支付方式编码（pm_id），支付通道省份，支付方式描述。每个参数之间用“|”间隔，每种支付通道之间也使用“|”间隔。 提示：解析此字符串时要注意有些语言需要用”\\|”来解析，如java中 String info = 2.00|4004; String[] a = info.split(\\|); 2.5 支付请求 请求方式 商户系统→19PAY支付网关 商户系统通过HTTP协议链接到19PAY进行支付，并按照接口参数定义以post传送相关数据。 接口地址 测试地址：08/card/pgworder/orderdirect.do (正试地址另行通知) 接口参数 参数 含义 长度 是否非空 备注 version_id 版本号 10 非空 本接口版本号：2.00 merchant_id 商户代码 20 非空 19PAY统一分配的商户代码 verifystring 验证摘要串 100 非空 32位小写详见验证方式 order_date 订单日期 10 非空 格式为‘YYYYMMDD’ order_id 商户订单号 30 非空 该订单号由商户系统生成。order_id唯一确定一条订单。 amount 订单金额 8 非空 单位为元，精确到分，格式为50.00 19pay系统默认充值卡面额与此参数值相同 cardnum1 充值卡卡号码的暗码 30 非空 使用DES算法，通过密钥对卡号加密。详见后续描述 cardnum2 充值卡密码的暗码 30 非空 使用DES算法，通过密钥对卡号加密。详见后续描述 currency 货币类型 8 非空 RMB：人民币 pm_id 支付方式id 20 非空 用于区分支付通道的类别，