快付宝API支付平台,网银在线支付接口文档说明

合集下载

api支付接口

api支付接口

api支付接口API支付接口概述:API支付接口是一种方便、安全和高效的电子支付方式。

它允许系统之间进行交互,并进行即时支付处理。

通过API支付接口,平台可以与第三方支付提供商集成,以接收付款并进行结算。

1. 接口功能API支付接口提供以下主要功能:- 创建支付订单:允许平台创建一个支付订单,指定货币类型和支付金额。

- 发送支付请求:将支付订单发送到第三方支付提供商进行支付处理。

- 接收支付结果:接收支付处理结果,包括成功,失败或待确认。

- 退款处理:允许平台发起退款请求,并接收退款处理结果。

2. 接口安全API支付接口需要确保支付信息的机密性和完整性。

以下是确保安全性的措施:- 加密传输:通过使用SSL(Secure Socket Layer)或TLS (Transport Layer Security)等协议对数据进行加密传输。

- 身份验证:在请求和响应中使用合适的身份验证方法,例如API密钥、数字签名等。

- 防范攻击:防止跨站脚本(XSS)、SQL注入、CSRF(跨站请求伪造)等攻击。

3. 接口集成要使用API支付接口,平台需要与第三方支付提供商进行集成。

以下是集成过程的一般步骤:- 注册账户:在支付提供商的网站上注册账户,获取API密钥或其他必要的凭证。

- 配置参数:将API密钥或其他凭证配置到平台的支付接口设置中。

- 开发集成代码:根据支付提供商的API文档,开发与其接口对接的代码。

- 测试集成:使用测试环境进行接口集成测试,确保支付流程的正确性和稳定性。

- 上线使用:完成集成测试后,可以切换到生产环境,正式投入使用。

4. 接口返回结果API支付接口的返回结果通常包括以下信息:- 支付状态:成功、失败或待确认。

- 支付订单号:支付订单的唯一标识符。

- 错误代码和错误描述:如果支付失败,则会提供相应的错误代码和错误描述。

5. 接口文档和技术支持API支付接口通常提供详细的接口文档,包括接口使用说明、参数说明、示例代码等。

云支付接口集成说明文档

云支付接口集成说明文档

云支付接口集成文档一、发起支付请求1、请求地址(采用GET方式)/i2eorder/yunpay/2、发起支付必要参数partner 云支付PID 必填seller_email 云支付账号(邮箱)必填out_trade_no 商户网站订单号(唯一)必填subject 商品名称必填total_fee 商品价格(整元)必填body 商品描述选填nourl 异步回调地址必填reurl 同步回调地址必填orurl 商品展示地址选填orimg 商品象形图片地址(网络地址)选填sign 客户端校验码(见第3点)必填3、sign生成方法首先需定义一个数组(如:$parameter),数组顺序必须按以下顺序定义:$parameter = array("partner" => ‘’,"seller_email" => ‘’,"out_trade_no" => ‘’,"subject" => ‘’,"total_fee" => ‘’,"body" => ‘’,"nourl" => ‘’,"reurl" => ‘’,"orurl" => ‘’,"orimg" => ‘’);注:不同语言定义数组方法不一样,但必须按此顺序定义。

而后通过foreach 函数将数据的值连接起来,如:foreach ($parameter as $pars) {$myparameter.=$pars;}$myparameter就是连接后的变量,有了它我们就可以生成sign了。

Sign就等于,变量$myparameter 连接固定字符串“i2eapi”而后再连接云支付KEY ,而后对其进行MD5加密(全为小写)就可以了(如PHP试例)$sign=md5($myparameter.'i2eapi'.$GLOBALS['i2ekeys']);4、发起支付将2中所有参数通过GET方式发送至1中的请求地址中,就可以了。

网银在线支付B2C系统商户接口文档v4.1

网银在线支付B2C系统商户接口文档v4.1

银行卡在线支付B2C系统商户接口规范版本(V4.1)网银在线(北京)科技有限公司目录1.文档说明 (4)1.1.文档目标 (4)1.2.阅读对象 (4)1.3.术语预定 (4)2.接口开发 (4)2.1.支付流程演示 (4)2.2.数据交互流程 (6)2.3.参数说明 (7)2.3.1编码格式 (7)2.3.2商户提交到网银在线 (7)2.3.3网银在线返回到商户 (8)2.3.3.1通过浏览器返回 (8)2.3.3.2服务器异步通知功能 (9)2.4.开发注意事项 (10)2.4.1必须设置MD5密钥 (10)2.4.2通知支付结果 (10)2.4.3订单不要重复处理 (11)2.5.采用MD5进行安全加密 (11)3.参考资料 (11)3.1.乱码问题 (11)3.2.常见问题 (12)3.3.网关错误列表 (12)4. 附录 (16)4.1. 网银在线资源 (16)4.2. 技术支持 (16)1.文档说明1.1.文档目标本文档是网银在线银行卡在线支付网关接口附录文档,它详细解释了在技术接入与使用过程中需要注意的地方,帮助商户快速理解和实现在线支付功能。

阅读后如有疑问,请联系网银在线相关技术支持。

1.2.阅读对象商户系统设计人员、编程人员及测试人员。

该人员需要具备一定的网站开发能力,了解JAVA、ASP、PHP、等开发语言中的一种,并对信息安全有一定的认识。

1.3.术语预定2.接口开发2.1.支付流程演示支付流程演示链接/aminute/ 支付流程如图:2.2.数据交互流程3:处理请求交易1.构造请求数据:消费者在商户网站选购商品或选择服务后,在商户网站提交订单;2.商户提交到网银在线:商户网站系统收集支付相关信息,如订单号、支付金额等提交至网银在线支付网关(接口文档send文件);3.处理请求交易:提交后,消费者浏览器页面将跳转到网银在线支付网关页面进行支付;4.浏览器返回:消费者支付完成后,网银在线支付网关通知商户支付结果,并跳转至商户指定的返回地址页面(接口文档中receive文件);5.服务器异步通知:当消费者完成支付后直接关闭浏览器后,网银在线的服务器会自动向商户后台发送交易信息(接口文档中autoreceive文件);6.对相应的数据进行处理:商户接收到支付结果信息后,可根据具体业务要求进行后续处理。

网银在线支付商户接口文档(B2C系统)

网银在线支付商户接口文档(B2C系统)

网银在线支付接口规范B2C系统商户接口平台版本号4.0网银在线(北京)科技有限公司目录1.文档介绍 (1)1.1. 读者对象 (1)1.2. 版权声明 (1)2.支付接口 (2)2.1. 商户>>> 网银在线支付 (2)2.2. 网银在线支付>>> 商户(页面返回) (5)2.3. 网银在线支付>>> 商户(服务器返回) (6)2.4. 网关错误编码表 (6)1.文档介绍1.1.读者对象商户系统设计人员、编程人员及测试人员1.2.版权声明此文档版权归网银在线(北京)科技有限公司所有。

作为本系统的最终用户,可以拥有该份文档的使用权,但未征得网银在线(北京)科技有限公司的书面批准,不得向第三方借阅、出让、出版该文档。

2.支付接口2.1.商户 >>> 网银在线支付示例程序:ChinaBank.html用途:收集信息并发送到数据发送页即Send页订单号://选填项,订单号收货人姓名://选填项,总长不超过80字符收货人地址://选填项,总长不超过200个字符收货人电话://选填项,总长不超过50个字符收货人邮编://选填项,总长不超过10个字符收货人邮件://选填项,总长不超过100个字符收货人手机号://选填项,总长不超过13个字符备注1://选填项,总长不超过150个字符订货人姓名://选填项,总长不超过80字符订货人地址://选填项,总长不超过200个字符订货人电话://选填项,总长不超过50个字符订货人邮编://选填项,总长不超过10个字符订货人邮件://选填项,总长不超过100个字符订货人手机号://选填项,总长不超过13个字符备注2://选填项,总长不超过150个字符订单总金额(元):*必填项,譬如:0.01示例程序:Send.asp、Send.aspx、Send.php、Send.jsp用途:接收ChinaBank.html发送过来的数据加密后发往网银在线电子支付平台的接口网关1、支付平台网关接口地址<form method=post action="https:///PayGate">2、FORM表单参数关,建议不用表1支付表单中的变量定义:—必填项—与网上支付货款无关项,建议不用表2MD5校验串生成方法:当消费者在商户端生成最终订单的时候,将订单中的v_amount v_moneytype v_oid v_mid v_url key六个参数的value值拼成一个无间隔的字符串(顺序不要改变)。

支付宝商家工具接口说明文档

支付宝商家工具接口说明文档

支付宝商家工具接口说明文档V2.02005-07-26前言浙江支付宝网络科技有限公司(以下简称支付宝公司)是国内先进的网络安全交易服务提供商,由全球最佳B2B公司――阿里巴巴公司创办,致力于为网络交易用户提供优质的安全交易解决方案。

支付宝交易,是支付宝公司针对网上交易而特别推出的安全交易服务,其运作的实质是以支付宝公司为信用中介,在买家确认收到商品前,由支付宝公司替买卖双方暂时保管货款的一种增值服务。

《支付宝商家工具接口说明文档》(以下简称《本文档》)详细描述了支付宝公司提供的“交易开放协议”(Trade Open Protocol,简称TOP协议)的内容,并指开发人员户如何利用TOP协议来为各个交易平台提供基于支付宝交易的安全交易服务。

关键字以下是经常出现在我们文档中的几个重要的关键字全称以及中文含义TOP协议:Trade Open Protocol 开放交易协议ATN:Active Trade Notify 主动交易通知AT:Active Trust 主动信任目录1. TOP协议整体架构概述 (5)简介 (5)1.1. TOP协议请求构造 (6)1.1.1. 简化版请求功能特点 (6)1.1.2. 标准版请求功能特点 (6)1.2. TOP协议请求使用,发送 (7)1.2.1. 简化版应用 (7)1.2.2. 标准版应用 (7)1.3. TOP协议使用的交易 (7)1.4. TOP协议的ATN (8)1.4.1. ATN前提条件 (8)1.4.2. 两个关键的通知环节 (8)1.4.3. 重发机制 (8)1.4.4. 商户系统故障恢复机制 (9)1.5. TOP协议的AT (10)1.5.1. AT:Active Trust (10)1.5.2. AT的时机 (10)2. TOP协议技术实施细节 (11)2.1. 实施前的准备 (11)2.1.1. 设置安全校验码 (11)2.1.2. 设置实时通知返回URL (13)2.2. 请求构造 (13)2.2.1. 标准版 (13)2.2.2. 简化版 (15)2.3. 处理ATN (15)2.3.1. sendOff:买家购买商品并付款 (16)2.3.2. checkOut:买家收到货,确认将款付到卖家帐户 (17)2.3.3. test:测试通知 (17)2.4. AT检验ATN的真实性 (18)2.5. 对账及意外数据处理 (19)附录 (21)附一:请求参数汇总表 (21)附二:通知参数汇总表 (23)附三:AT参数汇总表 (24)附四:支付宝交易流程图 (25)1.TOP协议整体架构概述图1-1:TOP协议时序图简介支付宝商家工具“开放交易协议”(Trade Open Protocol,简称TOP协议)是支付宝公司推出的强大的网络安全交易解决方案套件之一,通过该协议,用户既可以花费最小的时间成本的搭建支付宝交易平台,也可以利用其中强大的即时通知功能和虚拟发货功能,实现与支付宝交易系统的完美对接。

AliPay支付宝标准快速付款接口文档V151

AliPay支付宝标准快速付款接口文档V151

AliPay支付宝标准快速付款接口文档V151副标题:网银直连修订历史说明:本接口将支付宝即时到帐接口用作纯网关的功能做详细介绍。

在集成时处理机制和原有支付宝即时到帐一样,要求时必须增加默认支付方式(paymethod)和默认网银(defaultbank)2个参数目录1前言------------------------------------------------------------------------------------------------------------- 3 1.1概述----------------------------------------------------------------------------------------------------------- 3 1.2术语----------------------------------------------------------------------------------------------------------- 3 2接口功能及参数介绍---------------------------------------------------------------------------------------- 32.1标准即时到账接口(适用于纯网银) --------------------------------------------------------------- 32.1.1功能描述 ------------------------------------------------------------------------------------------ 32.1.2交互流程 ------------------------------------------------------------------------------------------ 42.1.3交互模式 ------------------------------------------------------------------------------------------ 42.1.4接口详细说明 ------------------------------------------------------------------------------------ 42.1.5接口注意事项 ----------------------------------------------------------------------------------- 102.1.6接口错误代码列表 ----------------------------------------------------------------------------- 11 3签名通用策略------------------------------------------------------------------------------------------------ 133.1安全方面C HECK L IST ------------------------------------------------------------------------------------ 13 3.2签名方面 -------------------------------------------------------------------------------------------------- 133.2.1签名机制 ----------------------------------------------------------------------------------------- 133.2.24.2.2签名方式 ------------------------------------------------------------------------------------- 13 3.3其他方面 -------------------------------------------------------------------------------------------------- 134附录------------------------------------------------------------------------------------------------------------ 144.1接口通用机制 -------------------------------------------------------------------------------------------- 144.1.1系统调用 ----------------------------------------------------------------------------------------- 144.1.2页面跳转 ----------------------------------------------------------------------------------------- 144.1.3支付宝主动通知处理流程 -------------------------------------------------------------------- 164.1.4通知验证 ----------------------------------------------------------------------------------------- 16 4.2数字签名构造 -------------------------------------------------------------------------------------------- 184.2.1要求参数构造 ----------------------------------------------------------------------------------- 18 4.3公用枚举表 ----------------------------------------------------------------------------------------------- 214.3.1通知返回结果枚举 ----------------------------------------------------------------------------- 214.3.2通用交易状态枚举表 -------------------------------------------------------------------------- 214.3.1银行列表 ----------------------------------------------------------------------------------------- 224.3.2信用卡大额银行列表 -------------------------------------------------------------------------- 234.3.3订单状态列表 ----------------------------------------------------------------------------------- 23 4.4FAQ(常见问题的的解答)-------------------------------------------------------------------------- 241前言1.1概述本接口要紧用在外部集成网银直连(纯网关)功能1.2术语2接口功能及参数介绍2.1标准即时到账接口(适用于纯网银)2.1.1功能描述调用此接口,依照用户传过来的参数创建交易,买家再付款。

企业付款API接口说明文档_V2 (1)(1)

企业付款API接口说明文档_V2 (1)(1)

书密码默认为您的商户
用来标识和界定您
ID(如:10010000)
的身份
证书 pem 格式

PHP 等不能直 您也可以使用 openssl
(apiclient_cert.pem) apiclient_cert.p12 接使用 p12 文 命令来自己导出:
中导出证书部分的 件,而需要使用 openssl pkcs12
业务结果 result_code 是
String( SUCCESS/FAIL
16)
错误代码 err_code

String( 错误码信息
32)
错误代码 err_code_de 否
String( 结果信息描述
描述
s
128)
以下字段在 return_code 和 result_code 都为 SUCCESS 的时候有返回
内部文档,请勿外传
内部文档,请勿外传
用户微信 weinxin_id 可


校验用户 check_name 是
姓名选项
收款用户 re_user_na 可
姓名
me

金额
amount

企业付款 desc

描述信息
Ip 地址 spbill_creat 是
e_ip
weiweiVIP OPTION_CHE CK
马总
10099 理赔 192.168.0.1
1.2 接口介绍
业务流程 付款
接口 企业付款
简介 用于企业向微信用户个人付款 目前支持向指定微信用户的 openid 或微信号付 款。(获取 openid 参见微信公众平台开发者文 档: 网页授权获取用户基本信息,微信号需用户 主动告知)

支付宝支付接口开发教程

支付宝支付接口开发教程

支付宝支付接口开发教程支付宝支付接口是支付宝提供的一种支付方式,能够方便地实现网上支付功能。

为了开发这个接口,我们需要以下几个步骤:第一步,申请支付宝开发者账号。

我们需要在支付宝官网上注册一个开发者账号,并获取开发者ID和密钥。

这些信息将在接下来的开发过程中使用。

第二步,创建应用。

在支付宝开发者平台上,我们需要创建一个应用,并获得应用ID。

创建应用时,需要填写一些基本信息,例如应用名称、应用回调地址等等。

第三步,下载SDK。

支付宝提供了多种开发语言的SDK,我们需要根据自己使用的语言下载相应的SDK,并将其导入到项目中。

第四步,编写代码。

根据支付宝提供的接口文档,我们需要编写代码来实现支付宝支付接口的功能。

首先,我们需要进行身份验证,将开发者ID和密钥传递给支付宝服务器。

然后,我们需要构建订单信息,包括商品名称、金额等等。

最后,我们需要调用支付宝的支付接口,生成支付链接或者二维码。

第五步,处理支付结果。

支付完成后,支付宝会向我们的应用回调地址发送支付结果通知。

我们需要编写代码来处理这些通知,例如更新订单状态等等。

第六步,测试和发布。

在开发完成后,我们需要进行测试,确保支付接口的功能正常。

如果一切正常,我们可以将应用发布到线上环境,供用户使用。

总结起来,开发支付宝支付接口需要进行申请账号、创建应用、下载SDK、编写代码、处理支付结果等一系列步骤。

通过这个接口,我们可以方便地实现网上支付功能,提升用户的支付体验。

希望这个教程对你有所帮助!。

api支付接口原理

api支付接口原理

api支付接口原理
API支付接口原理是指在网上支付过程中,商家与支付机构之
间通过API接口进行数据交换和传递的一种方式。

具体原理
如下:
1. 商家接入支付机构提供的API接口,通过API接口向支付
机构发起支付请求,并将支付相关的参数(如订单号、金额、商品信息等)传递给支付机构。

2. 支付机构收到支付请求后,会验证商家的身份和支付参数的完整性、合法性等。

如果验证通过,支付机构会生成一个支付页面或者支付链接返回给商家。

3. 商家将支付页面或者支付链接返回给用户,用户通过点击支付页面或者链接进入支付页面,选择支付方式(如支付宝、微信支付等)进行支付操作。

4. 用户支付完成后,支付机构会将支付结果(包括支付状态、支付金额、支付时间等)通知商家,通知方式可以是直接回调商家提供的接口,也可以是商家主动去查询支付结果。

5. 商家接收到支付机构的支付结果通知后,将支付结果进行处理并给用户返回相应的支付结果界面。

总的来说,API支付接口的原理就是商家通过API接口与支付机构进行数据传递和交互,实现支付过程中的数据传输、验证、处理和通知等功能,从而实现在线支付的功能。

网银在线支付接口和应用

网银在线支付接口和应用

网银在线支付接口和应用关键字: 网银在线支付接口和应用最近关注项目中在线支付,所以看一下文档,在线支付应用开发:基本所有的在线支付均采用以下方式:客户点击结帐时将关于訂單的信息和货币信息,相应的信息URL,经过md5或其他方式发送(可能Socket和Http或Https)支付平台(块钱,paypal或支付宝等),支付平臺处理完毕时根据相应URL,返回相关的信息(付款信息,訂單信息,验证信息).在实际操作Money的问题人们一向关注他的安全性等问题,同时本人习惯在通过http方式访问非外网时采用Commons-httpclient的post发送实现,简单方便,所以采用此种实现:具体看以下API和原代码:网银在线支付API接口:商户>>>>>>网银在线支付:<form method=post action="https:///select_bank"> <input type=hidden name=v_mid value="1001"> 商户编号<input type=hidden name=v_oidvalue="19990720-1001-000001234"> 订单编号<input type=hidden name=v_amount value="13.45"> 订单总金额<input type=hidden name=v_moneytype value="0"> 币种<input type=hidden name=v_url value="http://domain/program">支付动作完成后返回到该url,支付结果以POST方式发送<input type=hidden name=v_md5infovalue="1630DC083D70A1E8AF60F49C143A7B95"> 订单MD5校验码<input type="hidden" name="remark1 " value="">备注字段1<input type="hidden" name="remark2" value="">备注字段2<input type=hidden name=v_rcvname value="张三"> 收货人姓名<input type=hidden name=v_rcvaddr value="北京海淀"> 收货人地址<input type=hidden name=v_rcvtel value="68475566"> 收货人电话<input type=hidden name=v_rcvpost value="100036"> 收货人邮编<input type=hidden name=v_orderstatus value="0"> 商品信息<input type=hidden name=v_ordername value="李四"> 订货人姓名<input type=hidden name= v_orderemail value="test@"> 订货人邮件<input type=submit value="网银在线支付"></form>MD5校验串生成方法:当消费者在商户端生成最终订单的时候,将订单中的v_amount v_moneytype v_oid v_mid v_url key六个参数的value值拼成一个无间隔的字符串(顺序不要改变)。

在线支付接口文档

在线支付接口文档

在线支付接口文档I. 概述本文档提供了有关在线支付接口的详细说明。

在线支付接口可供开发人员使用,以便在他们的应用程序中实现支付功能。

本文档将介绍接口的功能、参数、请求和响应的格式以及示例代码。

II. 接口功能在线支付接口提供了以下主要功能:1. 发起支付请求:应用程序可以通过接口向支付平台发起支付请求,包括订单金额、支付方式等参数。

2. 处理支付回调:支付平台会在支付完成后通过接口向应用程序发送支付回调通知,以便应用程序更新支付状态等信息。

3. 查询订单状态:应用程序可以通过接口查询订单的支付状态、金额等详细信息。

III. 接口参数1. 商户参数:- 商户ID:用于标识商户的唯一身份。

- 商户密钥:用于对接口参数进行签名验证,确保请求的安全性和完整性。

2. 支付参数:- 订单号:用于唯一标识一笔订单。

- 订单金额:支付的金额,以货币单位表示。

- 支付方式:指定支付使用的方式,如支付宝、微信支付等。

3. 回调参数:- 状态码:支付平台发送的回调通知的状态码,用于验证通知的有效性。

- 支付状态:订单的支付状态,如支付成功、支付失败等。

- 其他支付相关信息:例如支付完成时间、支付流水号等。

IV. 请求和响应格式1. 请求格式:请求参数使用POST方法通过HTTPS协议发送,格式为JSON。

请求示例如下:```json{"merchant_id": "商户ID","timestamp": "请求时间戳","sign": "参数签名","data": {"order_no": "订单号","amount": "订单金额","payment_method": "支付方式"}}```其中,商户ID、请求时间戳以及参数签名需按接口规定进行生成和验证。

支付对接API文档

支付对接API文档

系统接口文档提交请求:提交地址: http://你的网关地址/Pay_Index.html 提交的参数MD5签名字段格式:将上表中红色的字段,按表中所列的顺序将请求字段组合成为待验证的一个无间隔字符串,然后将组合成的字符串加上你在支付系统上的密钥(key)后,通过MD5加密,就是待验证字符串hmacstr="pay_amount="+pay_amount+"&pay_applydate="+pay_applydate+"&pay_ bankcode="+pay_bankcode+"&pay_callbackurl="+pay_callbackurl+"&pay_memberi d=>"+pay_memberid+"&pay_notifyurl="+pay_notifyurl+"&pay_orderid="+pay_ord erid+"&key="+keyhmac= md5(hmacstr)然后将hmac 转换为大写订单通知:如果接收到服务器点对点通讯时,在页面输出“OK”(没有双引号,OK两个字母大写),否则会重复5次发送点对点通知验证签名字段格式:将上面的字段,按表中所列的顺序将请求字段组合成为待验证的一个无间隔字符串,然后将组合成的字符串加上你在平台的密钥(key)后,通过MD5加密,就是待验证字符串hmacstr=”amount=>”+amount+”&datetime=>”+datetime+”&memberid=>”+memberid+”&orderid=>”+orderid+”&returncode=>”+returncode+”&key=”+key Sign= md5(hmacstr)然后将Sign转换为大写支付渠道列表你的程序生成的订单号放在扩展字段里,传过来的订单号为空,让支付系统自动生成订单号,然后你那边要你生成的订单号,直接在返回的扩展字段里去获取你的程序的订单号就是他提交过来的数据里,订单号为空,就可以了,他生成的订单号放在扩展字段里,到时会原样返回给你/*修订时间2017 - 03 -21 */。

手机网站支付接口(alipay.wap.create.direct.pay.by.user)

手机网站支付接口(alipay.wap.create.direct.pay.by.user)
1.1 功能描述 ............................................................................................................................... 4 1.2 阅读对象 ............................................................................................................................... 4 1.3 业务术语 ............................................................................................................................... 4
版本号:1.0
支付宝(中国)网络技术有限公司 版权所有
手机网站支付接口
目录
1 文档说明 .............................................................................................................. 4
对获取的返回结果数据进行处理商户在同步通知处理页面参数returnurl指定页面文件或服务器异步通知页面参数notifyurl指定页面文件获取支付宝返回的结果数据后可以结合自身网站的业务逻辑进行数据处理如
手机网站支付接口
服务名称: er
7 通知返回数据处理.............................................................................................. 19

接口文档说明示例

接口文档说明示例

支付网关说明文档by:Q294500001目录##联盟支付网关说明文档........................................................................ 错误!未定义书签。

目录 .. (1)第一章文档描述.............................................................................................. 错误!未定义书签。

1、文档说明 (1)2、阅读对象 (1)第二章系统原理 (2)1、术语定义 (2)2、消费流程 (2)3、查询流程 (2)4、系统加密 (2)第三章网银接口定义 (3)1、同步过程接口定义(商户系统发起请求) (3)2、下行异步通知过程接口定义(##联盟接口发起请求) (5)3、下行同步通知过程接口定义(##联盟接口发起请求) (7)第四章查询流程接口定义 (8)第五章订单外部查询独立网址...................................................................... 错误!未定义书签。

附录1:##联盟支付网关银行类型说明. (9)第一章文档描述1、文档说明本说明文档用于指导##联盟商户实现与##联盟网银接口的顺利对接。

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

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

第二章系统原理1、术语定义商户:指已独立拥有在线销售系统,并成为##联盟网银接口系统会员,且已使用或者将使用##联盟网银接口实现收付费或其他相关功能需求的企业或者个人。

外部接入接口:指##联盟通过统一的方式接受外部请求的接口。

商户系统:指使用##联盟外部接入接口的计算机系统,一般指商户所拥有的在线销售系统。

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

商户ID:指##联盟为使用外部接入接口的商户统一分配的唯一标识。

支付宝标准快速付款接口文档

支付宝标准快速付款接口文档

支付宝标准快速付款接口文档1.接口概述支付宝标准快速付款接口是支付宝为商家提供的一种快速收款和付款的接口,通过该接口,商家可以方便地向用户收款或向用户付款。

2.接入流程商家接入该接口需要经过以下几个步骤:2.1.注册开发者账号商家需要在支付宝开放平台注册一个开发者账号,获取开发者ID和密钥。

2.2.签约接口协议商家需要和支付宝签约接口协议,获取商家ID和密钥。

2.3.开通快速付款功能商家需要在支付宝开放平台申请开通快速付款功能,并获取快速付款接口的接入点。

2.4.生成签名及请求参数商家根据接口文档中的要求,生成签名和请求参数,并将请求参数发送到快速付款接口的接入点。

2.5.接收响应并处理结果商家接收到支付宝的响应后,需要进行签名验证和结果处理,确认付款是否成功。

3.接口功能3.1.收款功能商家可以使用快速付款接口向用户收款。

商家需要提供用户的支付宝账号或手机号码,以及收款金额和收款说明。

支付宝会向用户的支付宝账号或手机号码发送一条收款请求,并等待用户确认。

3.2.付款功能商家可以使用快速付款接口向用户付款。

商家需要提供用户的支付宝账号或手机号码,以及付款金额和付款说明。

支付宝会向用户的支付宝账号或手机号码发送一条付款请求,并等待用户确认。

4.请求参数及返回结果4.1.请求参数商家在进行收款或付款请求时,需要传递以下参数:-商户订单号:商家自定义的订单号,用于唯一标识一笔交易。

-付款金额:需要收款或付款的金额。

-收款方账号:用户的支付宝账号或手机号码。

-付款说明:对收款或付款的说明信息。

4.2.返回结果支付宝在响应商家的请求时,会返回以下结果:-商户订单号:与商家传递的订单号一致。

-付款金额:与商家传递的付款金额一致。

-收款方账号:与商家传递的收款方账号一致。

-付款说明:与商家传递的付款说明一致。

-付款状态:表示付款是否成功,包括成功、失败、处理中等状态。

5.安全机制为了保证交易过程的安全,支付宝快速付款接口提供了以下安全机制:5.1.签名验证支付宝会对商家的请求参数进行签名,商家需要在接收到支付宝的响应后,进行签名验证,确保响应是由支付宝发送的。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

快付宝网银接口说明文档版本: 3.2发布日期: 2013-5-1目录第一章文档描述 (3)1、文档说明 (3)2、阅读对象 (3)第二章系统原理 (3)1、术语定义 (3)2、消费流程 (3)3、查询流程 (4)4、系统加密 (4)第三章网银接口定义 (4)1、上行过程接口定义(商户系统发起请求) (4)2、下行异步通知过程接口定义(快付宝接口发起请求) (7)3、下行同步通知过程接口定义(快付宝接口发起请求) (9)第四章查询流程接口定义 (10)第五章订单外部查询独立网址................................................................... 错误!未定义书签。

第六章测试................................................................................................... 错误!未定义书签。

附录1:快付宝网银接口银行类型说明.. (11)第一章文档描述1、文档说明本说明文档用于指导快付宝商户实现与快付宝网银接口的顺利对接。

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

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

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

外部接入接口:指快付宝通过统一的方式接受外部请求的接口。

商户系统:指使用快付宝外部接入接口的计算机系统,一般指商户所拥有的在线销售系统。

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

商户ID:指快付宝为使用外部接入接口的商户统一分配的唯一标识。

商户密钥:指商户在和快付宝确定合作意向时快付宝为商户提供的16位字符串。

该信息作为商户系统和快付宝交互时身份确认的依据,需商户妥善保管。

2、消费流程通常,一次支付最少包括2个交互过程。

第一个过程是商户系统将在线支付等信息提交到快付宝接口的过程,称之为上行过程。

第二个过程是在支付完成后,快付宝接口通过serverto server方式将支付结果告知商户系统的过程,称之为下行异步通知过程。

如果用户在跳转到快付宝接口完成支付操作后,需要快付宝接口将处理结果立即返回给商户系统的下一步页面,让用户继续完成整个操作流程,此时支付还应包括第三个流程,下行同步通知过程。

该过程需要在上行过程中提交参数hrefbackurl。

3、查询流程在商户系统将订单成功提交给快付宝接口后的任意时间,商户系统可发起请求查询订单的处理结果。

该流程由商户系统发起,由接口返回相应结果。

4、系统加密快付宝接口采用MD5加密方式对传输数据进行签名验证,具体请参考相关接口定义。

对MD5加密后的签名值,请注意结果的大小写务必正确。

为了确保签名值不是因为MD5加密算法而导致结果不正确,请各商户在调用接口前对字符串1234567890abcdefghijklmnopqrstuvwxyz使用MD5加密算法进行加密,若加密结果为928f7bcdcd08869cc44c1bf24e7abec6则表示MD5加密正常。

第三章网银接口定义1、上行过程接口定义(商户系统发起请求)1、接入URL:/bank.aspx2、接入方式:GET方式3、请求协议参数:表1 上行过程请求协议参数说明4、MD5签名说明待签名数据为表1中加入签名列值为Y的参数以及商户密钥,签名顺序为表1中parter 到callbackurl的顺序加商户密钥。

具体MD5签名源串及格式如下:parter={}&type={}&value={}&orderid ={}&callbackurl={}key其中,key为商户签名。

5、接入实例:(假设商户Id为99,商户密钥为1234567890abcdef)请求提交方法:/bank.aspx?parter=99&type=963&value=100.00&orderid=12345678 90&callbackurl=/backAction&refbackurl=/n otifyAction&payerIp =127.0.0.1&attach=ekapay&sign=fde74a4c040b5022cd9c4d9e6b917fcc 实际进行MD5加密的串是parter=99&type=963&value=100.00&orderid=1234567890&callbackurl=http://www.xunjiep /backAction1234567890abcdef,该串MD5加密结果为fde74a4c040b5022cd9c4d9e6b917fcc6、特别说明:①在接口使用中,商户系统内发起请求时应使用页面跳转的方式跳转到接口地址。

如在jsp中,使用response.sendRedirect(接口地址及参数),在.net中,使用Response.Redirect(接口地址及参数)。

②若hrefbackurl有效,则在跳转返回通知过程中,快付宝接口将使用相同方法跳转回商户系统,跳转地址是hrefbackurl。

③根据HTTP协议要求,提交参数的值中若存在特殊字符(如:空格、@等)时,为使快付宝接口能接收到正确的参数,这些特殊字符需要做URL Encoding。

需特别注意的是,此时待签名数据应该是原生值而不是encoding之后的值。

2、下行异步通知过程接口定义(快付宝接口发起请求)1、接入URL:过程1中请求参数callbackurl值2、接入方式:GET方式3、请求协议参数:表2 下行过程请求协议参数说明4、返回协议参数:表3 下行异步通知返回协议参数5、MD5签名说明:待签名数据为表2中加入签名列值为Y的参数以及商户密钥,签名顺序为表2中orderid 到ovalue的顺序加商户密钥。

具体MD5签名源串及格式如下:orderid={}&opstate={}&ovalue={}key其中,key为商户签名。

6、特别说明:①下行异步通知过程在整个支付流程中一定存在。

商户系统在收到下行通知过程后,需向快付宝接口返回类似opstate=0的结果。

快付宝接口根据该返回值判断商户系统是否已经收到结果。

若返回结果不是opstate=0(可能是opstate=-1、-2或者空),快付宝接口会根据商家和快付宝接口的约定,再次反复向callbackurl发送结果,直到商户返回opstate=0或者达到和商户约定的重复发送次数。

②当快付宝接口在下行异步通知过程中返回在线支付结果时,商户系统在收到数据后,应该通过sign值判断是否是有效的返回数据,防止数据在网络传输过程中被恶意篡改。

7、注意事项:①在收到快付宝接口订单下行异步通知结果时,商户系统需首先验证订单通知的合法性,如果不合法,则不要更新商户系统上的订单状态。

②商户系统内订单状态和订单实际金额务必以此次快付宝接口订单异步通知的结果为准。

③商户系统在成功提交订单后,在未没有收到快付宝接口异步通知结果时,请不要更新商户系统上的订单状态。

④商户系统收到异步通知结果后,处理流程可表示为:if(返回参数同表2表述不同)同步返回快付宝接口opstate=-1if(签名正确){if(opstate==0 或者== -3){按照成功处理商户系统内订单,订单实际金额为ovalue}else{按照失败处理商户系统内订单}同步返回快付宝接口opstate=0}else{同步返回快付宝接口opstate=-2}⑤在下行异步通知过程中商户系统返回结果值opstate回快付宝时,opstate的值并不是将快付宝在下行异步通知的结果原样返回。

商户系统返回值opstate=0时表示商户系统已经成功接收到了结果(不论结果是什么,总之是收到了),而其他值表示因为某些原因商户系统并不认为快付宝的返回是有效的。

快付宝在收到商户系统的返回后,如果返回的值为opstate=0,快付宝将不再次发送结果,否则快付宝会根据快付宝同商户的约定再次发送结果。

3、下行同步通知过程接口定义(快付宝发起请求)1、接入URL:过程1中请求参数hrefbackurl值2、接入方式:GET方式3、请求协议参数:该过程参数同表2所示。

4、特别说明:如果用户在跳转到快付宝接口完成支付操作后,需要快付宝接口将处理结果立即返回给商户系统的下一步页面,让用户继续完成整个操作流程,此时支付还应包括下行同步通知过程。

该过程需要在上行过程中提交参数hrefbackurl。

当快付宝在下行同步通知过程中返回在线支付结果时,商户系统在收到数据后,应该通过sign值判断是否是有效的返回数据,防止数据在网络传输过程中被恶意篡改。

第四章查询流程接口定义1、接入URL:/search.aspx2、接入方式:GET方式3、请求协议参数:表4 查询流程请求协议参数4、返回协议参数表5 查询流程返回协议参数5、MD5签名说明:①查询请求签名:待签名数据为表4中加入签名列值为Y的参数以及商户密钥,签名顺序为表4中orderid 到parter的顺序加商户密钥。

具体MD5签名源串及格式如下:orderid={}&parter={}key其中,key为商户签名。

②查询返回签名:待签名数据为表5中加入签名列值为Y的参数以及商户密钥,签名顺序为表5中orderid 到ovalue的顺序加商户密钥。

具体MD5签名源串及格式如下:orderid={}&opstate={}&ovalue={}key其中,key为商户签名。

附录1:快付宝网银接口银行类型说明表7 快付宝银行类型说明。

相关文档
最新文档