第三方充值平台接口开发文档..

第三方支付接口技术对接实现及样例随着电子商务和移动支付的蓬勃发展，第三方支付成为了一种便捷、安全的支付方式。

第三方支付接口技术对接实现是指将第三方支付平台的支付功能引入到自己的平台中，使用户可以直接在自己的平台上完成支付操作。

本文将介绍第三方支付接口技术对接的实现步骤，并提供一个简单的样例演示。

一．实现步骤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（余额卡支付版）北京高阳捷迅信息技术有限公司（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或其他字符。

傲付数卡点卡商城API点卡接口开发商户接口规范版本(2.0.0)目录第一章文档描述 (3)1、文档说明 (3)2、阅读对象 (3)第二章系统原理 (3)1、术语定义 (3)2、消费流程 (4)3、查询流程 (5)4、系统加密 (5)第三章点卡接口定义 (5)1、同步过程接口定义（商户系统发起请求） (5)2、下行异步通知过程接口定义（接口发起请求） (7)附录1：傲付数卡点卡商城支付接口卡类型说明 (9)第一章文档描述1、文档说明本说明文档用于指导傲付数卡点卡商城API商户实现与傲付数卡点卡商城API点卡接口的顺利对接。

请相关技术人员详细阅读本文档。

2、阅读对象商户开发人员。

傲付数卡点卡商城API点卡接口相关技术人员。

第二章系统原理1、术语定义商户：指已独立拥有在线销售系统，并成为傲付数卡点卡商城API点卡接口系统会员，且已使用或者将使用傲付数卡点卡商城API点卡接口实现收付费或其他相关功能需求的企业或者个人。

外部接入接口：指傲付数卡点卡商城API通过统一的方式接受外部请求的接口。

商户系统：指使用傲付数卡点卡商城API外部接入接口的计算机系统，一般指商户所拥有的在线销售系统。

用户：指在商户系统内进行消费的企业或者个人。

商户ID：指傲付数卡点卡商城API为使用外部接入接口的商户统一分配的唯一标识。

商户密钥：指商户在和傲付数卡点卡商城API确定合作意向时傲付数卡点卡商城API为商户提供的16 位字符串。

该信息作为商户系统和傲付数卡点卡商城API交互时身份确认的依据，需商户妥善保管。

2、消费流程一般地，在商户系统进行消费时，用户需要向商户支付一定的相关费用。

在集成了傲付数卡点卡商城销卡接口后，傲付数卡点卡商城销卡将为商户提供方便的收付费服务。

用户在商户系统发起消费请求后，商户系统和傲付数卡点卡商城销卡卡类接口系统（简写为傲付数卡点卡商城接口）的交互流程。

具体地，用户的一次消费中，商户系统和傲付数卡点卡商城接口之间会发生2 次直接交互过程。

基于Python的游戏app充值api调用代码实例代码描述：基于Python的游戏app充值api调用代码实例代码平台：聚合数据#!/usr/bin/python# -*- coding: utf-8 -*-import json, urllibfrom urllib import urlencode#----------------------------------# 游戏充值调用示例代码－聚合数据# 在线接口文档：/docs/88#----------------------------------def main():#配置您申请的APPKeyappkey ="*********************"#1.商品小类列表request1(appkey,"GET")#2.商品信息request2(appkey,"GET")#3.商品价格查询request3(appkey,"GET")#4.游戏直充区服查询request4(appkey,"GET")#5.游戏直充request5(appkey,"GET")#6.订单状态查询request6(appkey,"GET")#商品小类列表def request1(appkey, m="GET"):url ="/ofpay/game/cardlist"params ={"key": appkey, #应用APPKEY(应用详细页查询)}params =urlencode(params)if m =="GET":f =urllib.urlopen("%s?%s"%(url, params))else:f =urllib.urlopen(url, params)content =f.read()res =json.loads(content)if res:error_code =res["error_code"]if error_code ==0:#成功请求print res["result"]else:print"%s:%s"%(res["error_code"],res["reason"]) else:print"request api error"#商品信息def request2(appkey, m="GET"):url ="/ofpay/game/cardinfo"params ={"cardid": "", #对应接口1的cardid"key": appkey, #应用APPKEY(应用详细页查询)}params =urlencode(params)if m =="GET":f =urllib.urlopen("%s?%s"%(url, params))else:f =urllib.urlopen(url, params)content =f.read()res =json.loads(content)if res:error_code =res["error_code"]if error_code ==0:#成功请求print res["result"]else:print"%s:%s"%(res["error_code"],res["reason"]) else:print"request api error"#商品价格查询def request3(appkey, m="GET"):url ="/ofpay/game/cardprice"params ={"cardid": "", #对应接口2的cardid"key": appkey, #应用APPKEY(应用详细页查询)}params =urlencode(params)if m =="GET":f =urllib.urlopen("%s?%s"%(url, params))else:f =urllib.urlopen(url, params)content =f.read()res =json.loads(content)if res:error_code =res["error_code"]if error_code ==0:#成功请求print res["result"]else:print"%s:%s"%(res["error_code"],res["reason"]) else:print"request api error"#游戏直充区服查询def request4(appkey, m="GET"):url ="/ofpay/game/areaserver"params ={"cardid": "", #对应接口3的cardid"key": appkey, #应用APPKEY(应用详细页查询)}params =urlencode(params)if m =="GET":f =urllib.urlopen("%s?%s"%(url, params))else:f =urllib.urlopen(url, params)content =f.read()res =json.loads(content)if res:error_code =res["error_code"]if error_code ==0:#成功请求print res["result"]else:print"%s:%s"%(res["error_code"],res["reason"]) else:print"request api error"#游戏直充def request5(appkey, m="GET"):url ="/ofpay/game/order"params ={"cardid": "", #商品编码，对应接口3的cardid"cardnum": "", #购买数量"orderid": "", #订单号，8-32位数字字母组合"game_userid": "", #游戏玩家账号(game_userid=xxx@$xxx001 xxx@是通行证xxx001是玩家账号)"game_area": "", #游戏所在区域，没有则不填，具体参照接口4返回，URL Encode UTF8"game_srv": "", #游戏所在服务器，没有则不填，具体参照接口4返回，UR LEncode UTF8"key": appkey, #应用APPKEY(应用详细页查询)"sign": "", #校验值，md5(&lt;b&gt;OpenID&lt;/b&gt;+key+cardid+ca rdnum+orderid+game_userid+game_area+game_srv)}params =urlencode(params)if m =="GET":f =urllib.urlopen("%s?%s"%(url, params))else:f =urllib.urlopen(url, params)content =f.read()res =json.loads(content)if res:error_code =res["error_code"]if error_code ==0:#成功请求print res["result"]else:print"%s:%s"%(res["error_code"],res["reason"]) else:print"request api error"#订单状态查询def request6(appkey, m="GET"):url ="/ofpay/game/ordersta"params ={"orderid": "", #商家订单号，8-32位字母数字组合"key": appkey, #应用APPKEY(应用详细页查询)}params =urlencode(params)if m =="GET":f =urllib.urlopen("%s?%s"%(url, params))else:f =urllib.urlopen(url, params)content =f.read()res =json.loads(content)if res:error_code =res["error_code"]if error_code ==0:#成功请求print res["result"]else:print"%s:%s"%(res["error_code"],res["reason"]) else:print"request api error"if__name__ =='__main__':main()。