Copyright 北京高阳捷迅信息技术有限公司 2006-2010 1/1019PAY 捷迅支付卡兑换平台接口规范版本号 2.00（WEB 版）北京高阳捷迅信息技术有限公司版本更新记录：更新时间 更新内容 修改人2010-10-13 防钓鱼参数 孙逊 19PAY 高阳捷迅卡兑换平台接口规范 2.00（WEB版）Copyright 北京高阳捷迅信息技术有限公司 2006-2010 2/10目 录1. 概要 ....................................................................................................................................31.1. 目的 ....................................................................................................................................31.2. 版权声明 ............................................................................................................................31.3. 客户服务 ............................................................................................................................32. 支付接口 ............................................................................................................................42.1. 接口说明 ............................................................................................................................42.2. 订单支付类型说明 ............................................................................................................42.3. 网上支付业务流程 ............................................................................................................52.4. 支付请求 ............................................................................................................................62.5. 支付请求返回（前台通知） ............................................................................................72.6. 支付结果服务器端通知(后台通知) ................................................................................92.7. 注意事项 ..........................................................................................................................10 19PAY 高阳捷迅卡兑换平台接口规范 2.00（WEB版）Copyright 北京高阳捷迅信息技术有限公司 2006-2010 3/101. 概要1.1. 目的帮助商户接入 19PAY 卡兑换平台，快速掌握 19PAY 卡兑换平台各项功能，便于尽快投入使用。
1.2. 版权声明此文档版权归北京高阳捷迅信息技术有限公司所有作为本系统的最终用户，可以拥有该份文档的使用权，但未征得北京高阳捷迅信息技术有限公司的书面批准，不得向第三方借阅、出让、出版该文档1.3. 客户服务服务热线：400-019-1999 19PAY 高阳捷迅卡兑换平台接口规范 2.00（WEB版）Copyright 北京高阳捷迅信息技术有限公司 2006-2010 4/102. 支付接口2.1. 接口说明本接口主要目的是为了让商户系统接入 19PAY 捷迅卡兑换平台，能够通过预付费卡、电子钱包等方式快捷的实现电子支付 请求方式： 商户系统->19PAY 捷迅卡兑换平台商户系统作为请求客户端，按照本接口的约定发送请求，而 19PAY 捷迅卡兑换平台监听来自商户系统的请求给予处理，处理完成后返回商户系统2.2. 订单支付类型说明1） 、神州行充值卡神州行充值卡支付，商户请求信息到 19PAY 高阳捷迅卡兑换平台，19PAY 高阳捷迅网站显示让用户输入神州行缴费卡序列号和密码进行付费的页面。
不支持运营商的赠卡详细说明见: 、联通充值卡联通卡支付，商户请求信息到 19PAY 高阳捷迅卡兑换平台，19PAY 高阳捷迅网站显示让用户输入联通缴费卡卡号和密码进行付费的页面不支持运营商的赠卡3） 、电信充值卡电信卡支付，商户请求信息到 19PAY 高阳捷迅卡兑换平台，19PAY 高阳捷迅网站显示让用户输入联通缴费卡卡号和密码进行付费的页面不支持运营商的赠卡 19PAY 高阳捷迅卡兑换平台接口规范 2.00（WEB版）Copyright 北京高阳捷迅信息技术有限公司 2006-2010 5/102.3. 网上支付业务流程用户各支付系统捷迅网关商户从合作商户选择商品1组域发送支付请求2登陆相应支付系统选择支付方式346反馈支付结果支付5结果通知( 前后台 )78验证支付结果 ， 提供服务网上支付业务流程步骤说明：1) 消费者登录商户网站，选择支付内容并下单，商户网站产生预定单信息，商户提供商户唯一交易号、订单号、金额等信息；2) 消费者确认支付后，服务商将商户唯一交易号、订单号、支付金额、支付方式、产品名称等信息通过浏览器 URL传到 19PAY捷迅支付网站；（参考接口 2.4）3) 19PAY捷迅支付系统根据商户发送的支付方式自动转到不同的业务后台（联通、银行等）进行支付处理；4) 后台系统网站将处理信息返回到 19PAY捷迅支付； 5) 19PAY捷迅支付进行处理后，返回处理结果给消费者；6) 支付系统返回结果给捷迅网关；7) 19PAY捷迅支付通知商户用户已经付费成功，返回相关的定单信息和捷迅交易流水号；（参考接口 2.4，2.6）8) 商户收到信息进行验证，为用户提供服务。
19PAY 高阳捷迅卡兑换平台接口规范 2.00（WEB版）Copyright 北京高阳捷迅信息技术有限公司 2006-2010 6/102.4. 支付请求 请求方式商户系统 –> 19PAY 捷迅卡兑换平台商户系统的支付按钮通过 HTTP 协议链接到 19PAY 的接口地址，并按照接口参数定义以 post 传送相关数据商户系统的网站页面将转到 19PAY 捷迅卡兑换平台的网站页面关于防钓鱼功能，请详细看一下 2.7 的注意事项 接口地址测试地址：http://202.142.22.232/cardpage/bussOrder.do(正试地址另行通知) 接口参数参数 含义 长度 是否非空 备注version_id 版本号 10 非空 本接口版本号:2.00merchant_id 商户代码 20 非空 19PAY 统一分配的商户代码verifystring 验证摘要串 100 非空 32 位小写详见接后描述order_date 订单日期 8 非空 格式为‘YYYYMMDD’order_id 商户订单号 30 非空 该订单号由商户系统生成。
order_id 唯一确定一条订单amount 订单金额 8 非空 单位为元，精确到分,小数点后 2 位currency 货币类型 8 非空 RMB：人民币returl 支付请求返 回 url 128 非空本接口处理完成后，捷迅平台将重定向到该 url形式为： | 和¬ify_url 后台通知地 址 128 可空后台通知地址，如果空则以数据库配置为准，如果非空则以商户传入地址为准注意：地址请不要携带任何参数，如 | 和&pm_id 支付方式 id 20 可空用于区分支付通道的类别. 方式 id 列表另行提供.为空时:支付页面会显示 19PAY 为商户开通的所有支付方式. 如果不显示某一支付方式，可以赋空串如果要单独显示某一支付方式 pm_id 要赋值神州行： pm_id="CMJFK"联通缴费卡：pm_id="LTJFK"电信： pm_id="DXJFK"mx_ip 支付用户 IP 非空 19pay 系统防钓鱼参数商家需将支付用户的 IP 地址赋值给此参数pc_id 支付通道 id 20 可空 如果不显示某一支付方式，可以赋空串order_pname 商品名称 20 可空 显示在 19PAY 的页面order_pdesc 商品描述 255 可空 此参数提交之后在支付结果通知中可能不会再传回给商家，如需要依据请自行进行入库处理user_name 订货人姓名 10 可空 同上user_phone 用户 20 可空 同上user_mobile 用户号 20 可空 19PAY 高阳捷迅卡兑换平台接口规范 2.00（WEB版）Copyright 北京高阳捷迅信息技术有限公司 2006-2010 7/10user_email 用户 EMAIL 30 可空注意：商家所传参数请不要携带特殊字符，如单引号 双引号 等 验证方式本接口采用 MD5 摘要对请求进行确认。
验证失败的请求将不予处理商户首先需要向 19PAY 卡兑换平台申请商户代码（merchant_id）及加密串（merchant_key），并按照以下规则来构造验证摘要串（verifystring） MD5 摘要源串：version_id=%s&merchant_id=%s&order_date=%s&order_id=%s&amount=%s¤cy=%s&returl=%s&p。