支付宝开放平台支付产品接入最佳实践。涵盖当面付、订单码支付、App支付、 JSAPI支付、手机网站支付、电脑网站支付、预授权支付、商家扣款等全场景产品选型与集成指导。 当用户提到"接入支付宝"、"集成支付宝支付"、"对接支付"、"支付宝收款"、 "加个支付功能"、"支付宝下单"、"H5支付"、"小程序支付"、"预授权"、 "付款码"、"扫码支付"、"网页支付"、"PC支付"、"周期扣款"、"自动续费"、 "会员订阅"、"连续包月"、"代扣"时使用此 Skill。 不用于微信支付、银联支付、支付宝转账、对账、红包等非收单场景。
所有支付宝支付产品的文档均为在线动态链接,接入前务必先阅读对应产品的在线文档获取最新接口参数和代码示例。
访问支付宝在线文档时,直接使用 curl 获取内容:
# 示例:获取当面付文档
curl -sL "https://ideservice.alipay.com/cms/site/0izcu3"
文档页面内包含的链接需要递归访问以获取完整内容。访问流程:
# 访问当面付子链接示例
curl -sL "https://ideservice.alipay.com/cms/site/0izal0" # 产品介绍
curl -sL "https://ideservice.alipay.com/cms/site/0izal1" # 接入准备
根据用户的业务场景,路由到对应的产品文档:
| 场景 | 推荐产品 | 核心 API | 在线文档 |
|---|---|---|---|
| 线下门店,用户出示付款码,商家扫码枪扫码收款 |
| 当面付 |
alipay.trade.pay |
| 当面付文档 |
| 商家生成二维码,用户打开支付宝扫码付款 | 订单码支付 | alipay.trade.precreate | 订单码支付文档 |
| 手机浏览器 H5 页面内唤起支付宝付款 | 手机网站支付 | alipay.trade.wap.pay | 手机网站支付文档 |
| 电脑浏览器网页内跳转支付宝收银台 | 电脑网站支付 | alipay.trade.page.pay | 电脑网站支付文档 |
| 支付宝小程序内调起支付 | JSAPI 支付 | alipay.trade.create + my.tradePay | JSAPI 支付文档 |
| 原生 iOS/Android/鸿蒙 App 内调起支付宝付款 | App 支付 | alipay.trade.app.pay | App 支付文档 |
| 押金冻结、信用住、免押租赁 | 预授权支付 | alipay.fund.auth.order.app.freeze | 预授权支付文档 |
| 周期扣款、自动续费、会员订阅、连续包月 | 商家扣款 | alipay.trade.app.pay(支付并签约)+ alipay.trade.pay(后续扣款) | 商家扣款文档 |
回答任何接入问题或编写代码前,先通过 curl 阅读上表中对应的在线文档链接。文档内包含最新的接口参数、代码示例和注意事项。
用户咨询支付宝接入
|
+-- 线下门店收款?
| +-- 用户出示付款码,商家扫 --> 当面付
| +-- 商家出示二维码,用户扫 --> 订单码支付
|
+-- 线上支付?
| +-- 原生 App(iOS/Android/鸿蒙)--> App 支付
| +-- 支付宝小程序 --> JSAPI支付
| +-- 手机浏览器 H5 --> 手机网站支付
| +-- 电脑浏览器网页 --> 电脑网站支付
|
+-- 需要冻结资金/押金?
| +-- 预授权支付
|
+-- 周期性自动扣款?
+-- 会员订阅/连续包月/自动续费 --> 商家扣款
| 关键词 | 路由产品 |
|---|---|
| 付款码、条码支付、扫码枪、被扫、线下门店、便利店、商超、餐饮、收银台扫码、实体店、面对面收款、扫码枪收款、用户出示付款码 | 当面付 |
| 订单码、商家二维码、主扫、预下单、商家生成二维码、用户扫码支付、商品二维码、预创建订单 | 订单码支付 |
| H5支付、WAP支付、手机网站、手机浏览器、移动端网页、手机网页支付、wap收银台、手机端网页、移动H5 | 手机网站支付 |
| PC支付、电脑网站、网页支付、电脑端支付、PC网页、电脑浏览器、网站支付、传统网页支付、网页收银台 | 电脑网站支付 |
| 小程序支付、JSAPI、支付宝小程序、生活号、小程序内支付、小程序收银台、小程序JSAPI、my.tradePay、小程序下单、支付宝内小程序 | JSAPI 支付 |
| App支付、移动应用支付、iOS支付、Android支付、鸿蒙支付、App内支付、原生App支付、手机App支付、移动端App、SDK支付、客户端支付 | App 支付 |
| 预授权、押金、资金冻结、信用住、免押、先享后付、酒店押金、租车押金、充电宝押金、单车押金、民宿押金、冻结资金、授权冻结、押金退还 | 预授权支付 |
| 周期扣款、自动续费、会员订阅、连续包月、代扣、商家扣款、定期扣款、会员自动续费、包月会员、订阅制、定期扣费、委托扣款、协议扣款 | 商家扣款 |
当用户描述模糊时:
请确认您的业务场景:
1. 线下门店收款
- 当面付:用户出示付款码,商家用扫码枪收款
适用:便利店、商超综合体、餐饮店、医院、学校、电影院、旅游景区等实体门店
- 订单码支付:商家生成二维码,用户扫码付款
适用:商品售卖、媒体广告支付等场景
2. 线上App支付
- 原生 iOS/Android/鸿蒙 App 内调起支付宝付款
- App 未安装支付宝客户端时可降级 H5 支付
3. 支付宝小程序支付
- JSAPI支付:小程序内调起支付宝收银台完成支付
- 适用:支付宝小程序内购物、服务购买等场景
4. 手机网站支付
- 手机浏览器 H5 页面内唤起支付宝 App 或网页收银台
- 适用:移动端网页内支付等场景
5. 电脑网站支付
- 电脑浏览器跳转支付宝网页收银台
- 支持扫码支付或登录账户支付
- 适用:PC端电商网站、在线服务平台等
6. 预授权支付
- 先冻结资金或信用额度,按实际消费扣款,剩余解冻归还
- 适用:酒店民宿、传统租车、分时租赁、单车租赁、充电宝、雨伞、3C数码/手机/相机租赁等
7. 商家扣款(周期自动扣款)
- 用户签约授权后,商家主动发起周期性扣款
- 适用:会员包月、自动续费、定期还款等
请描述您的具体业务需求?
| 主题 | 说明 | 在线文档 |
|---|---|---|
| 服务端 SDK | 通用版 SDK(Java/PHP/.NET/Python/Node.js)、Easy 版 SDK(Java/PHP/.NET) | https://ideservice.alipay.com/cms/site/0j0cjj |
| 获取 AppId | 应用唯一标识的获取方式 | https://ideservice.alipay.com/cms/site/02nebp |
| 接口加签方式 | 加签方式说明,支持 RSA2 和 RSA,推荐使用 RSA2(SHA256WithRSA) | https://ideservice.alipay.com/cms/site/02mriz |
| 正式网关 | 访问地址:https://openapi.alipay.com/gateway.do | - |
| 沙箱网关 | 访问地址:https://openapi-sandbox.dl.alipaydev.com/gateway.do | https://ideservice.alipay.com/cms/site/02np8i |
| 接入规范和常见陷阱 | 支付产品接入中的核心规范和产品接入常见陷阱说明 | https://ideservice.alipay.com/cms/site/0j0kl2 |
| 公共错误码说明 | 此处为公共错误码说明,开发者在接入过程中遇到其他报错信息,可以参考所调用接口的 API 文档的 业务错误码 部分 | https://ideservice.alipay.com/cms/site/02km9f |