快速接入 - 支付宝文档中心

快速接入

更新时间：2025-09-25 19:03:10

本文档展示了 ISV（独立软件开发商）如何从零开始，使用支付宝开放平台服务端 SDK 快速接入当面付快捷版产品，完成与支付宝对接。

注意：文档中的代码示例和 Demo 是用来阐述API基本使用方法的，仅针对大众场景，供 ISV 参考，特殊情况还请 ISV 自行扩展，确保符合自身业务需求。

第一步：入驻成为系统服务商（ISV ）

要在您的应用中使用支付宝开放产品的接口能力，您需要先通过支付宝账号登录支付宝开放平台（

open.alipay.com

），根据 平台入驻 指引入驻开放平台。

若您已经入驻开放平台，您需要查看并确认您的角色。点击右上角的 账户中心 > 主账号管理，下拉到“角色身份”处查看您的合作伙伴角色，如下图所示：

注意：如您目前的角色还不是系统服务商ISV，请点击“立即拓展”增加角色并如实填写相关信息。填写完成后点击确认并提交审核。

第二步：创建应用

在角色审核通过后开发者就可以在开放平台的开发中心进行应用的开发。点击 控制台 并进入 三方服务 创建第三方应用。在创建应用时，选择 自定义接入 ，如下图所示：

在接入后首先需要完善应用信息，如下图所示：

在完善应用信息后，点击“确认创建”，系统会自动跳转到应用详情页面。点击“添加功能”来添加当面付快捷版。选择“支付收单”页签，选择“当面付快捷版”，并点击确认，如下图所示：

注意：选择功能时，开发者要特别注意所选功能是否需要商户签约，并确定商户是否具备对应签约资质，如商户无法获得签约，则该功能会无法使用。

第三步：配置应用

在创建应用后，开发者需要对应用进行网关、回调地址、加签方式等开发配置，如下图所示：

开发者调用接口前需要先生成 RSA 密钥，RSA 密钥包含应用私钥（APP_PRIVATE_KEY）、应用公钥（APP_PUBLIC_KEY）。生成密钥后，开发者需要在开放平台开发者中心进行密钥配置，配置完成后可以获取支付宝公钥（ALIPAY_PUBLIC_KEY）。详细步骤请参考《配置应用环境》。 完成配置后，点击 “完成配置，下一步”，成功创建应用。

第四步：代商家签约

代商家提交资料

ISV 开发者可以通过开放平台提供的接口，代替商家提交签约资料，代商家签约的接口调用顺序如下图所示：

1

通过 alipay.open.agent.create（开启代商户签约、创建应用事务接口）创建应用事务，返回生成 batch_no。

2

通过 alipay.open.agent.offlinepayment.sign（代签约线下收钱产品接口）代替商家签约线下收钱产品，传入第一步生成的 batch_no 参数。

3

通过 alipay.open.agent.confirm（提交代商户签约、创建应用事务接口）提交事务，同样需要传入第一步生成的 batch_no 参数。

4

通过 alipay.open.agent.order.query （查询申请单状态接口）查询代签的结果。

5

商户完成确认签约授权后，系统会通过异步消息发送到开发者在应用设置里设置的应用网关。异步消息包含商家的 token，是 ISV 代商家发起交易的必须要素，一定要妥善保管。

注意：商家的 token 非常重要，如果遗忘了商家的 token，开发者可以这样找回：

1

进入开放平台运营中心，点击“运营工具”，选择左侧“商家管理”目录下的“我的商家”，如下图所示：

2

选择“应用授权信息”页签，在这里可以看到已经开通代签约的商家的 token， 如下图所示：

签约结果通知

如果签约审核通过，支付宝会通过以下3个渠道通知到商家：

●

邮件：通知邮件将发送至 ISV 提交签约时输入的联系人邮箱；

●

短信：通知短信将发送至 ISV 提交签约时输入的联系人手机号；

●

支付宝APP：对签约的商家账号通过“蚂蚁金服商家平台”生活号发送一条模板消息，商家可在支付宝APP的“朋友”中查看，如下图所示：

如果签约未通过，支付宝不会通知到商家。服务商可以通过 alipay.open.agent.order.query （查询申请单状态接口）。建议提交后5分钟进行第一次查询，之后每过4小时查询一次。

商家确认

签约审核通过后，商家可通过点击短信中的短链接或者APP内模板消息直接进入确认页。这里需要商家输入已签约的支付宝账号进行登录，如下图所示：

通知邮件中也有确认链接，商家点击以后在web端登录支付宝，然后用手机APP扫二维码在手机上完成确认，如下图所示：

第五步：代商家发起交易

在完成代签约之后， ISV 开发者可以代商家发起一笔交易，体验支付接入流程。 点击查看更多

详细接入指南

。 当面付快捷版根据不同的支付场景，调用不同的支付接口，适用于以下支付方式。

付款码支付

条码支付是支付宝给到线下传统行业的一种收款方式。客户出示支付宝APP的付款码，商家使用扫码枪等条码识别设备扫描用户支付宝钱包上的条码/二维码，完成收款。用户仅需出示付款码，所有收款操作由商家端完成。 根据支付金额的大小，付款码支付分为免密支付和非免密支付。

免密支付 因为付款码支付一般定位为小额免密支付，所以免密支付是主流，交互也比较简单。付款码免密支付流程如下图所示：

非免密支付 如果支付的金额比较大，则会唤起用户的收银台，用户需要输入支付密码后才能支付成功，流程如下图所示：

注意：接口传入的 appid 请传入第三方应用的 appid；token 需要传入商家的 token（如何查看 token 请参考第四步的“注意”部分）；商家的 pid 可以不用传入，开放平台会自动解析。

扫码支付

通过支付宝钱包上的扫一扫功能扫商户二维码，用户可以调用支付宝接口完成下单购买的流程，具体流程如下图所示：

注意：接口传入的 appid 请传入第三方应用的 appid；token 需要传入商家的 token（如何查看 token 请参考第四步的“注意”部分）；商家的 pid 可以不用传入，开放平台会自动解析。

扫订单码支付

客户在支付宝app内，扫二维码（注意这个二维码是支付宝官方发的二维码）直接唤起收银台支付。

注意：扫订单码支付与扫码支付的区别，扫码支付指用户在扫完二维码后打开的是 ISV 开发者的 H5 页面，在 H5 页面输入金额生成订单后直接唤起支付宝的收银台进行支付。而扫订单码支付在扫完二维码后，不会打开 ISV 开发者的 H5 页面，而是直接唤起支付宝的收银台进行支付。

扫订单码支付具体流程如下图所示：

第六步：上线应用

应用开发完成后，请开发者自行进行验收和安全性检查（安全性检查可参考《开放平台第三方应用安全开发指南》），验收检查完成后，可申请上线，上线成功后，状态变为已上线，这个状态下的应用能够调用生产环境的接口。点击了解详细 上线应用步骤 和 线上验收步骤 。