第三方充值平台接口开发文档..
博迈话费充值接口文档_v1.3.0
datetime
时间戳：格式YYYYmmddHHMMSS，如20170614151823
数据校验：以上参数以URL形式组合，再加上SP提供的KEY，取MD5值，不不区分大大小小
sign
写，校验原文文如下（其中加号为字符串串链接）：
cpid=CPID&orderid=ORDERID&datetime=DATETIME+KEY
数据校验：以上参数以URL形式组合，再加上SP提供的KEY，取MD5值，不不区分大大小小
sign
写，校验原文文如下（其中加号为字符串串链接）：
cpid=CPID&datetime=DATETIME+KEY
应用用示例例（POST和GET方方式均可，生生产环境接口口地址请联系客服索取）
http://127.0.0.1/api/money? cpid=10001&datetime=20140101080000&sign=abd3f45e6dd4ae2da919e88083a6c322
请求
参数
说明
cpid
商户ID：由SP分配，如10001
orderid
商户订单号：必须唯一一，且不不超过20位，由字⺟母数字组成
status
订单状态：0 充值失败、1 充值成功
datetime
时间戳：格式YYYYmmddHHMMSS，如20170614151823
数据校验：以上参数以URL形式组合，再加上SP提供的KEY，取MD5值，不不区分大大小小
应用用示例例（POST和GET方方式均可，生生产环境接口口地址请联系客服索取）
http://127.0.0.1/api/search? cpid=10001&orderid=10000000000000000000&datetime=20140101080000&sign=abd3f45e6dd4a e2da919e88083a6c322
第三方支付接口技术对接实现及样例
第三方支付接口技术对接实现及样例随着电子商务和移动支付的蓬勃发展，第三方支付成为了一种便捷、安全的支付方式。
第三方支付接口技术对接实现是指将第三方支付平台的支付功能引入到自己的平台中，使用户可以直接在自己的平台上完成支付操作。
本文将介绍第三方支付接口技术对接的实现步骤，并提供一个简单的样例演示。
一．实现步骤1. 选择第三方支付平台2. 获取商户账号和密钥注册第三方支付平台的商户账号，并获取对应的商户密钥。
商户账号和密钥用于身份验证和加密等操作。
3. 接口文档阅读仔细阅读第三方支付平台提供的接口文档，了解接口的功能和使用方式。
接口文档中通常包含接口的请求参数、返回参数、加密方式、签名算法等关键信息。
4. 接口参数配置根据接口文档配置请求参数。
一般需要配置商户账号、订单号、金额、支付方式等基本参数。
5. 发起支付请求根据接口文档的要求，利用开发语言发送请求到第三方支付平台。
请求可以使用HTTP或者HTTPS协议进行传输。
请求中需要包含商户账号、密钥等身份验证参数，同时还需要传递订单信息和支付金额等相关参数。
6. 处理支付结果7. 订单查询和退款如果需要查询订单状态或者发起退款操作，可以通过调用第三方支付平台的查询接口或者退款接口实现。
二．样例演示假设我们选择支付宝作为第三方支付平台，演示如何使用支付宝支付接口。
1. 注册支付宝商户账号并获取密钥。
2. 阅读支付宝开放平台的接口文档。
3. 配置请求参数。
例如，在发起支付请求时，我们需要配置商户账号、订单号、金额等参数。
4. 调用支付宝的支付接口，向支付宝传递请求参数。
```javapublic class AlipayDemopublic static void main(String[] args)//配置请求参数String appId = "YOUR_APP_ID";String merchantId = "YOUR_MERCHANT_ID"; double amount = 100.0;//构造请求URL//发起支付请求String result = sendRequest(url);//处理支付结果if (result.equals("success"))System.out.println("支付成功！");} elseSystem.out.println("支付失败！");}}private static String sendRequest(String url) //发送HTTP请求，并获取服务器响应//TODO:发送HTTP请求的代码...return "success"; // 假设返回结果为成功}```以上代码演示了如何使用支付宝支付接口，其中`sendRequest`方法需要根据具体的编程语言和第三方支付平台的要求实现。
聚速通视频会员充值接口文档
聚速通视频会员充值接口文档1、编写目的 (2)2、网络协议 (2)3、签名和安全 (2)4、接口说明 (3)4.1 参数的获取 (3)4.2充值接口 (3)4.3查询接口 (4)4.4异步通知接口 (5)4.5余额查询接口 (6)5、报文状态说明 (6)5.1订购接口说明 (6)5.2查询接口说明 (7)1、编写目的本文档说明了充值平台下游对接供货接口协议（即通过网络向聚速通充值平台发送视频会员（包括腾讯视频、优酷土豆、爱奇艺视频等）充值订单，由聚速通平台完成视频会员充值功能的应用场景下，需遵循此协议规则），供使用该接口的合作商和本项目的后续开发维护人员使用。
2、网络协议（1）返回格式为默认为xml，如果http请求返回500错误，务必在请求头Accept加上application/xml；如需返回json格式，请把http 请求头中的Accept 改为application/json;charset=UTF-8。
（2）下单操作为异步请求，报文返回成功，则表示受理成功，具体充值是否成功，则需要我方发起异步通知，或者下游发起查询请求来判断。
3、签名和安全加密方式为MD5 。
将请求参数中的各个键值对按照key的字符串顺序升序排列（自然序），value拼成一串之后最后加上密钥组成字符串,取utf8字节后再做md5加密(32位小写)。
privateKey(密钥)由充值平台方分配，请妥善保存。
上线之前请告知充值平台方技术，请求服务器IP列表，通过IP 白名单加强交易安全。
4、接口说明4.1 参数的获取1、找商务人员获取用户编号（userId）、下单地址、privateKey以及商品编码。
2、提供回调地址及IP给商务人员绑定4.2充值接口http://XXXXX/unicomAync/buy.do?sign=b5b316640bc7fb908d5dc4851e6f9874& uid=186********&dtCreate=20160620145557&userId=236&itemId=14977&seria lno=1466405757596返回：<?xml version="1.0" encoding="UTF-8" ?><response><status>success</status><code>00</ code ><desc>交易成功</desc><amount>29718</amount> //交易总金额<areaCode>330000</areaCode> //省域代码<bizOrderId>37088</bizOrderId> //充值平台方流水号订单号<carrierType>3</carrierType> //运营商类别<itemFacePrice>3000</itemFacePrice> //商品面值单位为厘<itemId>136</itemId> //商品编号<itemName>全国移动话费3元</itemName><price>29718</price> //商品单价<serialno>123333</ serialno> //合作方流水号</response>注：此处返回"交易成功"，表示受理成功，并不代表，充值成功，下游代理商需要通过异步通知接口，获取发起查询请求来确保充值是否成功。
19pay捷迅充值卡兑换平台直联接口文档2.00(卡余额卡)
北京高阳捷迅信息技术有限公司19PAY 捷迅支付商户接口规范版本号2.00（余额卡支付版）北京高阳捷迅信息技术有限公司（19PA Y）最后修改2009年11月1日目录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注意事项............................................................................... 错误！未定义书签。
1.概要1.1目的帮助商户接入19PA Y支付平台，快速掌握19PA Y支付平台各项功能，便于尽快投入使用。
1.2版权声明此文档版权归北京高阳捷迅信息技术有限公司所有。
作为本系统的最终用户，可以拥有该份文档的使用权，但未征得北京高阳捷迅信息技术有限公司的书面批准，不得向第三方借阅、出让、出版该文档。
1.3客户服务服务热线：400-019-19992.支付接口2.1 接口说明本接口主要目的是为了让商户系统接入19PA Y支付平台，能够通过预付费卡等方式快捷的实现电子支付。
请求方式：商户系统→19PA Y支付平台商户系统作为请求客户端，按照本接口的约定发送请求，而19PA Y支付平台监听来自商户系统的请求给予处理，处理完成后返回商户系统，同时提供查询接口。
2.2订单支付类型说明1、神州行充值卡神州行充值卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅卡兑换平台，高阳捷迅卡兑换平台进行处理。
不支持运营商的赠卡2、联通充值卡联通卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅卡兑换平台，高阳捷迅卡兑换平台进行处理。
不支持运营商的赠卡3、电信充值卡电信充值卡支付，玩家在商户网站页面输入卡号密码，商户请求信息到高阳捷迅卡兑换平台，高阳捷迅卡兑换平台进行处理。
腾讯财付通接口的开发
财付通支付网关商户开发指南目录1引言 (4)1.1文档概述 (4)1.2阅读对象 (4)1.3业务术语 (4)2方案概述 (4)2.1行业背景 (4)2.2接口介绍 (5)2.3业务实现流程 (6)3交互模式 (6)3.1页面跳转交互模式 (6)3.2后台系统调用交互模式 (7)3.3后台通知交互模式 (8)4数据格式 (8)4.1GET或POST (8)4.2XML数据格式 (9)4.3字符串格式 (9)5数字签名 (9)5.1签名原始串 (10)5.2签名算法 (10)5.2.1MD5签名 (10)6补单机制 (10)7接口 (11)7.1支付接口 (11)7.1.1业务功能 (11)7.1.2交互模式 (11)7.1.3请求参数列表 (11)7.1.4返回结果和通知参数列表 (13)7.1.5后台通知结果反馈 (15)7.2通知查询接口 (15)7.2.1业务功能 (15)7.2.2交互模式 (15)7.2.3请求参数列表 (15)7.2.4应答参数列表 (16)7.3订单查询接口 (17)7.3.1业务功能 (17)7.3.2交互模式 (17)7.3.3请求参数列表 (17)7.3.4应答参数列表 (18)7.4退款接口 (20)7.4.1业务功能 (20)7.4.2交互模式 (20)7.4.3请求参数列表 (21)7.4.4应答参数列表 (22)7.5退款明细查询接口 (23)7.5.1业务功能 (23)7.5.2交互模式 (23)7.5.3请求参数列表 (23)7.5.4应答参数列表 (25)8实例 (26)9注意事项 (28)1引言1.1 文档概述本文描述了财付通针对合作商户提供的支付解决方案，帮助商户轻松实现在线收款的功能。
文档分别从交互模式、签名、接口、注意事项等方面详细介绍了财付通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。
开发者调用和包缴费接口例子说明
开发者调用缴费接口例子说明一、运行环境Jdk1.5、tomcat6.0二、说明授权请求地址：https:///open/sandbox/auth/service/extreq?response_type=code&client_id=10001702&redirect_uri=http://192.168.1.169:8082/&scope=phonecharge:1.0令牌获取地址:https:///open/sandbox/auth/service/token接口请求地址:/open/sandbox/mpop/2/phonecharge/1.0 Sandbox为沙箱环境，生产环境需去掉Sandbox。
三、操作步骤工程部署之后，打开地址http://127.0.0.1:9999/TestApp/端口根据实际情况修改如下图所示：点击【授权】获取令牌如下图所示跳转到应用授权页面如下图：授权成功后客户端跳转到http://127.0.0.1:9999/TestApp/AuthCallBack令牌接收地址该接收地址是一个Servlet，Servlet拿到授权码后用HttpClient方式再取回令牌其中应用证书、通知地址、取令牌地址根据情况进行修改取令牌后跳转到http://127.0.0.1:9999/TestApp/apptest.jsp?accesstoken=66754c6fa134d07eeea1c5794 0c78b65输入完整接口信息后点击【获取参数串】取到参数按升序排列后的值66754c6fa134d07eeea1c57940c78b6510001720json150732070622012112 811411215073207062MD5用test.app.Test类对参数串值MD5签名Test类需要根据情况修改点击【接口测试】后服务返回处理结果（JSON格式）状态为API00000表示成功。
接口开发合同范本
接口开发合同范本甲方（委托方）：_____________地址：_____________法定代表人：_____________联系电话：_____________乙方（开发方）：_____________地址：_____________法定代表人：_____________联系电话：_____________鉴于甲方需要开发一套接口系统，乙方具有相应的开发能力，双方本着平等、自愿、互利的原则，经协商一致，特订立本合同，以资共同遵守。
第一条合同目的甲乙双方就甲方委托乙方开发接口系统事宜达成一致，乙方应按照甲方的要求完成接口开发工作。
第二条接口开发内容1. 乙方应根据甲方提供的技术需求文档，开发符合要求的接口系统。
2. 接口系统应包括但不限于以下功能：_____________。
第三条开发周期1. 乙方应在合同签订之日起____天内完成接口系统的初步开发。
2. 接口系统开发完成后，乙方应提供给甲方进行测试，测试周期为____天。
3. 甲方应在测试周期内完成测试并提出修改意见，乙方应在收到修改意见后____天内完成修改。
第四条质量保证1. 乙方保证所开发的接口系统符合甲方的技术需求文档，并保证其正常运行。
2. 乙方应提供接口系统的技术支持和维护服务，维护周期为自接口系统交付之日起____年。
第五条合同价款及支付方式1. 本合同总价款为人民币（大写）：__________元整（￥__________）。
2. 甲方应在合同签订后____天内支付合同总价款的____%作为预付款。
3. 接口系统开发完成并通过甲方测试后，甲方应支付合同总价款的剩余____%。
第六条知识产权1. 乙方开发的接口系统及其相关文档的知识产权归甲方所有。
2. 乙方应保证所开发的接口系统不侵犯任何第三方的知识产权。
第七条保密条款1. 双方应对合同内容及在履行合同过程中知悉的对方商业秘密负有保密义务。
2. 未经对方书面同意，任何一方不得向第三方披露合同内容或商业秘密。
财付通接口文档及代码
财付通API接口文档样例代码引言文档概述本文描述了财付通开放平台的JAVA SDK，帮助开发者轻松实现在线支付、收付款等功能。
文档详细介绍了财付通开放平台的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。
阅读对象具有WEB程序开发背景，了解JAVA语言。
业务术语接口业务流程支付流程支付流程中，用户在财付通APP中购买业务，通过财付通支付平台进行支付。
典型业务流程如下：买家在财付通APP上浏览下单购买一个商品，财付通APP会生成一个支付链接，此链接通过用户的浏览器跳转到财付通开放平台，财付通通过此链接获取支付请求的参数，引导用户完成支付过程。
用户在财付通完成支付后，财付通通过return_url将用户浏览重新定向到财付通APP，财付通APP 向用户提示订单状态和后续操作。
同时，财付通会通过后台回调财付通APP的notify_url，财付通APP在收到支付结果通知后可以根据通知ID查询通知内容，在确保支付成功后再进行业务逻辑处理（例如发货），这样可以进一步提高安全性，防止伪支付成功结果的诈骗。
通知查询/订单查询流程通知查询/订单查询是指财付通APP向财付通系统发送查询请求，并同步等待财付通系统处理完毕后返回的响应数据。
数据交互是财付通APP与财付通服务器直接通信。
例如用户在财付通APP查询时，财付通APP要确认用户某个订单是否支付成功，可以向财付通发送一个查询请求，财付通收到请求后返回查询结果，财付通APP处理结果后再显示给用户。
后台通知流程后台通知是指财付通系统主动向财付通APP发送通知数据，并同步等待财付通APP处理完毕后返回的响应数据。
数据交互是财付通服务器与财付通APP直接通信，一般请求采用http的get或post，应答用字符串格式。
用户在财付通支付成功后，财付通会在后台通过notify_url向财付通APP发起通知，财付通APP 处理后成功返回success，失败返回fail或其他字符。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
API接口说明书
目录
1、API介绍 (3)
1.1通讯协议 (3)
1.2充值流程 (3)
1.3权限版本（power） (3)
1.4版本号（ver） (4)
1.5时间戳（timestamp） (4)
1.6订单号（orderid） (4)
1.7数字签名（sign和signkey） (4)
2、API调用说明 (5)
2.1在线充值 (5)
2.2订单回调 (7)
2.3商品进价表 (7)
2.4渠道商信息 (9)
2.5游戏区服表 (11)
2.6用户余额 (12)
2.7手机号码归属地 (12)
2.8系统时间戳 (13)
2.9销售软件 (13)
2.10激活码开通软件 (14)
2.11下级用户列表 (15)
2.12财务记录 (16)
2.13订单记录 (17)
2.14转账 (19)
3、注意事项 (19)
4、通用状态码 (20)
5、附录 (20)
5.1全国省份直辖市ID对照表 (20)
1、API介绍
1.1通讯协议
1. 联系速度达技术（QQ：1551369420）获取密钥KEY，及接口地址。
2. 接口采用GET/POST方式提交请求
3. 返回XML或JSON，传入参数增加format=xml或者format=json 1.2充值流程
一次请求保存在本地
1 请求时间戳
系统启动，获取服务器时间戳 [api/sys_now]
2请求产品表、渠道表、区服表
获取充值产品表 [api/product]、渠道表
[api/product_channel]、区服表 [api/product_area](该步骤执行一次存储在本地即可)
多次请求3选择产品
根据所要充值的业务需要先调用本地数据(游戏充值需调用区服表、手机充值需调用渠道表并请求归属地 [api/sys_phone])，然后选择产品。
4提交订单
将充值订单提交到充值接口 [api/recharge]。
其中productid 就是api/product的 i ；area的值就是手机号码归属地对应的值（见附录）如果是游戏则是api/product_area的i。
5回调订单状态
回调订单状态 [api/status]。
1.3权限版本（power）
13代表普及版
15代表专业版
16 代表豪华版
17 代表旗舰版
1.4版本号（ver）
固定值等于3，每个api接口必须要传的参数。
1.5时间戳（timestamp）
时间戳是自1970 年 1 月 1 日（00:00:00 GMT）至当前时间的总秒数。
时间戳的有效期为10分钟。
如果您的本机时间为准确的“北京时间”，可使用本机时间戳，否则可通过接口获取当前服务器的时间戳，以它为基本，开始自动计时。
时间戳是很多接口必须要传的一个参数。
时间戳的目的是为了使一个接口产生的URL在10分钟后失效，提高安全性。
1.6订单号（orderid）
为防止重复提交，很多接口都必须传入订单号。
建议按如下方法生成：
取系统当前时间按年月日小时分钟秒毫秒，再与用户编号用字母“v”相连。
生成如：20131112170125156v123456
1.7数字签名（sign和signkey）
sign 以时间戳作为秘钥
signkey 以KEY值和时间戳作为秘钥
如下请求为例，来说明signkey生成步骤
http://***/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=13 84243215&to=138********&username=test4@&ver=3&signkey=d38d6a9180d9d7791fb11f187813 c105
将除“signkey”外的所有参数按key进行字典升序排列，将接口名和排序后的参数(key=value)用&拼接起来。
例如：
/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=1384243215&to=138**** ****&username=test4@&ver=3&
将上面生成的字符串连上用户设置的秘钥进行URLencode转码，把转码后的字符串进行MD5加密，即是s ignkey。
signkey=md5(URLencode(/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp= 1384243215&to=138********&username=test4@&ver=3&用户秘钥))
sign则是以/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=1384243215&t
o=138********&username=test4@&ver=3进行进行URLencode转码，把转码后的字符串进行M D5加密。
sign=md5(URLencode(/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=138 4243215&to=138********&username=test4@&ver=3))
2、API调用说明
2.1在线充值http://***/api/recharge
2.2订单回调(建议下单成功1分钟后调用) http://***/api/status
返回参数说明：
2.3商品进价表http://***/api/product
返回参数说明：
2.4渠道商信息http://***/api/product_channel
返回参数说明：
2.5游戏区服表http://***/api/product_area
2.6用户余额http://***/api/userinfo
返回参数说明：
2.7手机号码归属地http://***/api/sys_phone
返回参数说明：
2.8系统时间戳http://***/api/sys_now
2.9销售软件http://***/exe/agent_open
返回参数说明：
2.10激活码开通软件http://***/exe/activation_agent_open
返回参数说明：
2.11下级用户列表http://***/es/agent_list
返回参数说明：
2.12财务记录http://***/es/finance_list
2.13订单记录http://***/es/recharge_list
返回参数说明：
2.14转账http://***/es/transfer_accounts
3、注意事项
1.系统对同一IP的充值请求频次限制在30秒90次。
如果商户的交易量超过该频次限制的话，切记不要把交易请求通过同一IP发送。
2.系统对提交的充值请求只进行单次处理，如果交易过程出现错误，该笔交易被视为无效请求，系统不会再继续处理该交易请求（如已对商户进行扣款的，系统会自动在当日或次日进行退款）。
商户需根据自己的实际情况确定是否再次发起充值请求。
3.如部分订单未及时退款的，请商户联系我们的在线客服查单退款。
4.本系统所有参数及MD5加密串均为小写。
5.因速度达API接口基于Linux+Java架构，所以URL区分大小写。
6.所有请求接口都需传入username参数
7.URLEncode转码注意各语言的差异，本系统采用的是.URLEncode.encode()，相对应的c#用
Uri.EscapeDataString()。
4、通用状态码
5、附录
5.1全国省份直辖市ID对照表。