支付宝支付接入
支付宝开放平台,致力于为开发者提供支付、理财、信用、口碑开店、安全、营销、社交等各类能力及行业解决方案。
1、支付宝应用接入流程
| 流程 | 说明 |
|---|---|
| 1、创建应用 | 应用介绍 创建应用 应用安全开发指南 设计规范 |
| 2、开始开发 | 了解产品 快速接入 更多帮助与支持 |
| 3、上线使用 | 上线应用 使用应用 签约功能 发布到服务市场 |
2、应用简介
通过创建应用的方式接入蚂蚁各项产品(如当面付、开店、发券、服务窗、余利宝等)接口并进行开发。
目前开放平台的应用按使用对象分为两类:自研型应用 和 第三方应用(商户服务型应用):
| 应用类型 | 说明 |
|---|---|
| 自研型应用 | 使用开放的功能,为自己或自己公司开发应用。自研型应用分为网页/移动,小程序,生活号。 |
| 第三方应用 | 适用于服务商,为商户开发应用,拓展商户使用 |
如果您的应用为第三方应用(即供商家使用),则需要商家对该应用进行授权,详细步骤可以参考 第三方应用授权。
创建应用 -> 应用配置 -> 上线应用 -> 签约功能(如手机网站支付,APP支付等)-> 开发接入已签约功能
- 开发者使用支付宝账号登录开放平台(需实名认证的支付宝账号),根据实际需求创建应用(如“支付应用”)。
输入名称,上传应用图标,选择应用功能(如手机网站支付,APP支付等),下载签名工具生成生成商户应用私钥和商户应用公钥,回到开放平台的应用完善页面,点击设置应用公钥,接收验证码,输入上一步生成的商户应用公钥,点击确定。然后会生成对应的支付宝公钥,商户应用公钥和支付宝公钥要明确区分开。
开发代码中要使用到 支付宝公钥 和 商户应用私钥
提交审核,一天之后,审核完成,显示应用上线。签约选择的应用功能,开始代码开发。
3、手机网站支付接入(H5网站)
- 3.1、业务场景
移动网页应用无需集成SDK也可以唤起支付宝客户端支付。
在网页应用中调用支付宝提供的网页支付接口,接口会调起支付宝客户端内的支付模块,此时会从商家网页应用跳转到支付宝客户端中并开始支付;支付完成后会跳转回商家网页应用内,最后商家展示支付结果。
- 3.2、接入条件
- 申请前必须拥有经过实名认证的支付宝账户;
- 企业或个体工商户可申请;
- 需提供真实有效的营业执照,且支付宝账户名称需与营业执照主体一致;
- 网站能正常访问且页面显示完整,网站需要明确经营内容且有完整的商品信息;
- 网站必须通过ICP备案。如为个体工商户,网站备案主体需要与支付宝账户主体名称一致;
- 如为个体工商户,则团购不开放,且古玩、珠宝等奢侈品、投资类行业无法申请本产品。
- 费率按单笔计算;一般行业费率:0.6%;
- 特殊行业费率:1.2%,特殊行业范围包括:手机、通讯设备销售;家用电器;数码产品及配件;休闲游戏;网络游戏点卡、渠道代理;游戏系统商;网游周边服务、交易平台;网游运营商(含网页游戏)
- 3.3 开发前准备&快速接入
1、创建应用并获取APPID
登录蚂蚁金服开放平台(open.alipay.com),登记个人应用后,审核通过将会得到应用的唯一标识(APPID)。
2、配置密钥
开发者调用接口前需要先生成RSA密钥,RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY)。
详情见:https://docs.open.alipay.com/291/105971/
3、下载服务端SDK
下载地址:https://docs.open.alipay.com/203/105910/
4、接口调用配置
5、调用接口
手机网站支付产品包含两类API:
页面跳转类:需要从前端页面以Form表单的形式发起请求,浏览器会自动跳转至支付宝的相关页面(一般是收银台或签约页面),用户在该页面完成相关业务操作后再回跳到商户指定页面。例如本产品中的手机网站支付接口alipay.trade.wap.pay。
系统调用类:直接从服务端发起HTTP请求,支付宝会同步返回请求结果。例如本产品中的交易查询等配套API。
接口调用流程

👋👋👋👋
- 3.4、手机网站支付产品包含的接口和描述如下:
| 接口名称 | 描述 |
|---|---|
| alipay.trade.wap.pay 手机网页支付接口 | 通过此接口传入订单参数,同时唤起支付宝手机网页支付页面 |
| alipay.trade.close 交易关闭接口 | 通过此接口关闭此前已创建的交易,关闭后,用户将无法继续付款。仅能关闭创建后未支付的交易。 |
| alipay.trade.query 交易状态查询接口 | 通过此接口查询某笔交易的状态,交易状态:交易创建,等待买家付款;未付款交易超时关闭,或支付完成后全额退款;交易支付成功;交易结束,不可退款。 |
| alipay.trade.refund 交易退款接口 | 通过此接口对单笔交易完成退款操作 |
| alipay.trade.fastpay.refund.query 退款查询 | 查询退款订单的状态 |
| alipay.data.dataservice.bill.downloadurl.query 账单查询接口 | 调用此接口获取账单的下载链接 |
4、如何使用沙箱环境做开发调试
沙箱环境是开放平台提供给开发者调试接口的环境,具体操作步骤见沙箱接入指南。
目前支付宝沙箱环境支持手机网站支付,并且在安装了沙箱支付宝钱包后,可以唤起沙箱支付宝钱包进行支付。
在没有应用或者应用还未上线及未签约支付功能时,可使用沙箱环境做开发联调,联调完成后,切换回商家应用APPid,商家私钥,商家公钥,支付宝公钥,做线上真实逻辑测试。
下载支付宝开放平台助手 -> 生成RSA商家应用私钥、公钥 -> 沙箱环境配置生成的应用公钥获取到支付宝公钥 -> AliPAySdk配置秘钥 -> 安装沙箱环境支付宝APP -> 客户端网页调用支付接口 -> 拉起沙箱环境支付宝APP -> 完成支付
5、其他
基于AliPaySDK的沙箱环境支付DEMO:
Demo Repo: https://github.com/fanguyun214/alipay-node-demo
扫码体验(微信环境不能拉起支付宝):
