AliPay支付宝标准快速付款接口文档(专用纯网关)V151

纯网关Alipay.comAlipay.com1纯网关接口文档副标题：网银直连修订历史版本号作者修订章节修订原因修订日期V1.0技术支持团队全版修改加强文档结构的合理性2008-11-17V1.1甘宁订正部分接口参数和描述信息，例如：即时支付支持错误通知地址（error_notify_url）更新签约接口内容接口升级、增加查询签约接口2009-8-2V1.2甘宁重新整理流程以及文档说明使文档阅读性更强2009-12-8V1.3甘宁增加“公用回传参数”满足用户自定义参数的要求2010-3-18V1.4甘宁通知中增加网银流水满足商户网银支付需求2010-3-29V1.5甘宁请求参数列表支持自定义超时可以使用时间区间2010-9-13V1.5.1甘宁增加4.3.2的信用卡简码信用卡大额支付也支持纯网关2010-10-26说明：本接口将支付宝即时到帐接口用作纯网关的功能做详细介绍。在集成时处理机制和原有支付宝即时到帐一样，请求时必须增加默认支付方式（paymethod）和默认网银（defaultbank）2个参数目录1前言-------------------------------------------------------------------------------------------------------------31.1概述-----------------------------------------------------------------------------------------------------------31.2术语-----------------------------------------------------------------------------------------------------------32接口功能及参数介绍----------------------------------------------------------------------------------------3纯网关Alipay.comAlipay.com22.1标准即时到账接口（适用于纯网银）---------------------------------------------------------------32.1.1功能描述------------------------------------------------------------------------------------------32.1.2交互流程------------------------------------------------------------------------------------------42.1.3交互模式------------------------------------------------------------------------------------------42.1.4接口详细说明------------------------------------------------------------------------------------42.1.5接口注意事项-----------------------------------------------------------------------------------112.1.6接口错误代码列表-----------------------------------------------------------------------------113签名通用策略------------------------------------------------------------------------------------------------133.1安全方面CHECKLIST------------------------------------------------------------------------------------133.2签名方面--------------------------------------------------------------------------------------------------133.2.1签名机制-----------------------------------------------------------------------------------------133.2.24.2.2签名方式-------------------------------------------------------------------------------------133.3其他方面--------------------------------------------------------------------------------------------------144附录------------------------------------------------------------------------------------------------------------144.1接口通用机制--------------------------------------------------------------------------------------------144.1.1系统调用-----------------------------------------------------------------------------------------144.1.2页面跳转-----------------------------------------------------------------------------------------144.1.3支付宝主动通知处理流程--------------------------------------------------------------------164.1.4通知验证-----------------------------------------------------------------------------------------174.2数字签名构造--------------------------------------------------------------------------------------------184.2.1请求参数构造-----------------------------------------------------------------------------------184.3公用枚举表-----------------------------------------------------------------------------------------------214.3.1通知返回结果枚举-----------------------------------------------------------------------------214.3.2通用交易状态枚举表--------------------------------------------------------------------------214.3.1银行列表-----------------------------------------------------------------------------------------224.3.2信用卡大额银行列表--------------------------------------------------------------------------234.3.3订单状态列表-----------------------------------------------------------------------------------244.4FAQ（常见问题的的解答）--------------------------------------------------------------------------24纯网关Alipay.comAlipay.com31前言1.1概述本接口主要用在外部集成网银直连(纯网关)功能1.2术语名称说明外部商户、合作伙伴、商户和支付宝进行业务合作的商户通知页参数名称Notify_url，所指定的互联网HTTP地址，当代扣完成之后，支付宝发送信息到该页面去，即调用该页面，该页面中的程序自动运行，并判断请求与处理获取到的信息合作伙伴ID签约后，为商家自动分配的唯一编号。分润分润指将某一部分费用分给其它的帐户页面跳转执行操作后跳转到其它页面2接口功能及参数介绍2.1标准即时到账接口（适用于纯网银）2.1.1功能描述调用此接口，根据用户传过来的参数创建交易，买家再付款。目前该接口的交易全部为即时到帐纯网银支付接口，即只要买家一付款，钱就会从买家银行卡转到卖家的支付宝账号。同时该接口还支持分润，商家传过来分润的账号和金额，系统会自动打款到该账号上。纯网关Alipay.comAlipay.com42.1.2交互流程2.1.3交互模式请求/响应交互模式，页面跳转2.1.4接口详细说明2.1.4.1请求参数列表特别注意：a.)此接口只支持https请求，支付宝是以https进行验证b.)按照支付宝外部请求接口概述中要求的签名方式，对输入参数进行签名，该接口请求才能够被支付宝系统接收。c.)本接口支持重复调用，但是提交数据必须一样才可以。d.)在请求时必须增加默认支付方式和默认网银2个参数字段名变量名类型说明可空协议参数接口名称serviceStringcreate_direct_pay_by_usN纯网关Alipay.comAlipay.com5er合作伙伴IDpartnerString(16)合作伙伴在支付宝的用户ID与支付宝签约后自动生成N通知URLnotify_urlURL（String(190)）针对该交易的交易状态同步通知接收URL。N返回URLreturn_urlURL结果返回URL，仅适用于立即返回处理结果的接口。支付宝处理完请求后，立即将处理结果返回给这个URL。N错误通知地址（需要支付宝功能人员开通）error_notify_urlURL（String(190)）如果在交易过程中出错（如签名错误等），则通过此URL将错误码返回给合作伙伴系统Y签名signString见签名机制，MD5加密算法后得出的结果N签名方式sign_typeString见签名方式，现今默认是MD5加密，无需更改该参数的值N参数编码字符集_input_charsetString（默认为GBK）合作伙伴系统与支付宝系统之间交互信息时使用的编码字符集。合作伙伴可以通过该参数指定使用何种字符集对传递参数进行编码。同时，支付宝系统也会使用该字符集对返回参数或通知参数进行编码。注：该参数必须在queryString中传递，不论使用的是POST还是GET方式发送请求。如：=utf-8N业务参数商品展示网址show_urlString(400)点击商品链接后跳转的页面Y商品名称subjectStrin