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

纯网关接口文档 副标题：网银直连 修订历史 版本号 作者 修订章节 修订原因 修订日期 V1.0 技术支持团队 全版修改 加强文档结构的合理性 2008-11-17 V1.1 甘宁 订正部分接口参数和描述信息，例如：即时支付支持错误通知地址（error_notify_url） 更新签约接口内容 接口升级、增加查询签约接口 2009-8-2 V1.2 甘宁 重新整理流程以及文档说明 使文档阅读性更强 2009-12-8 V1.3 甘宁 增加“公用回传参数” 满足用户自定义参数的要求 2010-3-18 V1.4 甘宁 通知中增加网银流水 满足商户网银支付需求 2010-3-29 V1.5 甘宁 请求参数列表 支持自定义超时可以使用时间区间 2010-9-13 V1.5.1 甘宁 增加4.3.2的信用卡简码 信用卡大额支付也支持纯网关 2010-10-26 说明： 本接口将支付宝即时到帐接口用作纯网关的功能做详细介绍。 在集成时处理机制和原有支付宝即时到帐一样，请求时必须增加默认支付方式（paymethod）和默认网银（defaultbank）2个参数 目 录 1 前言 3 1.1 概述 3 1.2 术语 3 2 接口功能及参数介绍 3 2.1 标准即时到账接口（适用于纯网银） 3 2.1.1 功能描述 3 2.1.2 交互流程 4 2.1.3 交互模式 4 2.1.4 接口详细说明 4 2.1.5 接口注意事项 11 2.1.6 接口错误代码列表 11 3 签名通用策略 13 3.1 安全方面CheckList 13 3.2 签名方面 13 3.2.1 签名机制 13 3.2.2 4.2.2签名方式 13 3.3 其他方面 14 4 附录 14 4.1 接口通用机制 14 4.1.1 系统调用 14 4.1.2 页面跳转 14 4.1.3 支付宝主动通知处理流程 16 4.1.4 通知验证 17 4.2 数字签名构造 18 4.2.1 请求参数构造 18 4.3 公用枚举表 21 4.3.1 通知返回结果枚举 21 4.3.2 通用交易状态枚举表 21 4.3.1 银行列表 22 4.3.2 信用卡大额银行列表 23 4.3.3 订单状态列表 23 4.4 FAQ（常见问题的的解答） 24  前言 概述 本接口主要用在外部集成网银直连(纯网关)功能 术语 名称 说明 外部商户、合作伙伴、商户 和支付宝进行业务合作的商户 通知页 参数名称Notify_url，所指定的互联网HTTP地址，当代扣完成之后，支付宝发送信息到该页面去，即调用该页面，该页面中的程序自动运行，并判断请求与处理获取到的信息 合作伙伴ID 签约后，为商家自动分配的唯一编号。 分润 分润指将某一部分费用分给其它的帐户 页面跳转 执行操作后跳转到其它页面 接口功能及参数介绍 标准即时到账接口（适用于纯网银） 功能描述 调用此接口，根据用户传过来的参数创建交易，买家再付款。目前该接口的交易全部为即时到帐纯网银支付接口，即只要买家一付款，钱就会从买家银行卡转到卖家的支付宝账号。同时该接口还支持分润，商家传过来分润的账号和金额，系统会自动打款到该账号上。 交互流程 交互模式 请求/响应交互模式，页面跳转 接口详细说明 请求参数列表 特别注意： 此接口只支持https请求，支付宝是以https进行验证 按照支付宝外部请求接口概述中要求的签名方式，对输入参数进行签名，该接口请求才能够被支付宝系统接收。 本接口支持重复调用，但是提交数据必须一样才可以。 在请求时必须增加默认支付方式和默认网银2个参数 字段名 变量名 类型 说明 可空 协议参数 接口名称 service String create_direct_pay_by_user N 合作伙伴ID partner String(16) 合作伙伴在支付宝的用户ID与支付宝签约后自动生成 N 通知URL notify_url URL（String(190)） 针对该交易的交易状态同步通知接收URL。 N 返回URL return_url URL 结果返回URL，仅适用于立即返回处理结果的接口。支付宝处理完请求后，立即将处理结果返回给这个URL。 N 错误通知地址 （需要支付宝功能人员开通） error_notify_url URL（String(190)） 如果在交易过程中出错（如签名错误等），则通过此URL将错误码返回给合作伙伴系统 Y 签名 sign String 见签名机制，MD5加密算法后得出的结果 签名方式 sign_type String 见签名方式，现今默认是MD