19pay捷迅充值卡兑换平台直联接口文档2.00卡余额卡.doc

北京高阳捷迅信息技术有限公司 19PAY 捷迅支付商户 接口规范 版本号 2.00 （余额卡支付版） 北京高阳捷迅信息技术有限公司（ 19PAY） 最后修改 2009 年 11 月 1 日 Copyright 高阳捷迅 2006-2010 北京高阳捷迅信息技术有限公司 目 录 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 注意事项 错误！未定义书签。 Copyright 高阳捷迅 2006 －2010 1/11 北京高阳捷迅信息技术有限公司 概要 1.1 目的 帮助商户接入 19PAY 支付平台，快速掌握 19PAY 支付平台各项功能，便于尽快投入使用。 1.2 版权声明 此文档版权归北京高阳捷迅信息技术有限公司所有。 作为本系统的最终用户， 可以拥有 该份文档的使用权， 但未征得北京高阳捷迅信息技术有限公司的书面批准， 不得向第三方借阅、出让、出版该文档。 1.3 客户服务 服务热线： 400-019-1999 Copyright 高阳捷迅 2006 －2010 2/11 北京高阳捷迅信息技术有限公司 支付接口 2.1 接口说明 本接口主要目的是为了让商户系统接入 19PAY 支付平台， 能够通过预付费卡等方式快捷的实现电子支付。 请求方式： 商户系统→ 19PAY 支付平台 商户系统作为请求客户端，按照本接口的约定发送请求，而 19PAY 支付平台监听来自 商户系统的请求给予处理，处理完成后返回商户系统，同时提供查询接口。 2.2 订单支付类型说明 1、 神州行充值卡 神州行充值卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅卡兑 换平台，高阳捷迅卡兑换平台进行处理。不支持运营商的赠卡 2、 联通充值卡 联通卡支付， 玩家在商户网站页面输入卡号密码， 商户请求信息到高阳捷迅卡兑换平台， 高阳捷迅卡兑换平台进行处理。不支持运营商的赠卡 3、 电信充值卡 电信充值卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅卡兑换 平台，高阳捷迅卡兑换平台进行处理。不支持运营商的赠卡 ■ 详细说明见 : /page/pgwpage/help.jsp 2.3 网上支付业务流程 Copyright 高阳捷迅 2006 －2010 3/11 北京高阳捷迅信息技术有限公司 1 从合作商户选择商品 , 输入支付信息 用户 6 验证支付结果，提供服务 商户 发 送 支 后 请 付 台 通 求 2 支 知 结 付 果 5 3 下单到相应支付系统 捷迅网关 4 反馈支付结果 各支付系统 网上支付业务流程步骤说明： 1、 用户登录商户网站， 选择商品、 输入充值卡卡号、 密码等支付信息，商户网站产生预定 单信息，包括商户唯一交易号、订单号、金额、充值卡号及充值卡密码等信息； 2、 用户确认支付后，服务商将商户唯一交易号、订单号、支付金额、支付方式、产品名称 等信息发送到高阳捷迅卡兑换平台； （参考接口 2.5 ） 3、 高阳捷迅系统根据商户发送的支付方式自动转到不同的支付系统 （神州行、 联通等） 进 行支付处理； 4、 各支付系统将处理信息返回到高阳捷迅卡兑换平台； 5、 高阳捷迅卡兑换平台进行处理后， 返回处理结果及相关的订单信息和捷迅交易流水号给 商户服务器；（参考接口 2.6 ） 6、 商户收到信息进行验证，为用户提供服务。 2.4 支付通道查询 请求方式 商户系统 → 19PAY 卡兑换平台 商户系统以 HTTP Post 的方式请求 19PAY 的接口地址， 并按照接口参数定义传送数据。 19PAY 卡兑换平台将以 html 方式返回查询结果。 接口地址 测试环境 32/card/channel.jsp Copyright 高阳捷迅 2006 －2010 4/11 北京高阳捷迅信息技术有限公司 接口参数 参数 含义 长度 是否非空 备注 merchant_id 商户代码 20 非空 19PAY 统一分配的商户代码 接口返回 返回所有支付通道的四个相关属性组成的字符串：支付通道编码（ pc_id），支付方式编 码（ pm_id ），支付通道省份，支付方式描述。每个参数之间用“ |”间隔，每种支付通道之 间也使用“ |”间隔。 提示：解析此字符串时要注意有些语言需要用 ”\\|”来解析，如 java中 String info = 2.00|4004 ; String[] a = info.split( \\| ); 2.5 支付请求 请求方式 商户系统→ 19