支付宝支付配置教程

更新于

支付宝配置是启用支付宝线上交易能力的基础,支持移动端、网页端支付、订单查询、退款、接收交易异步通知等核心支付业务。

1. 配置项目信息所需:

如需在项目中接入支付宝线上交易服务,通常需要配置以下凭证信息:

  • ALIPAY_APP_ID:支付宝正式应用 ID;

  • ALIPAY_PRIVATE_KEY:支付宝应用签名私钥;

  • ALIPAY_PUBLIC_KEY:支付宝公钥;

  • ALIPAY_NOTIFY_URL:支付宝异步回调地址;

  • ALIPAY_GATEWAY_URL:支付宝网关地址(是固定不变的:正式生产网关|沙箱测试网关);

  • ALIPAY_SIGN_TYPE:支付宝签名类型(官方标准值为RSA2);

  • ALIPAY_FORMAT:支付宝响应格式(官方标准值为JSON);

  • ALIPAY_CHARSET:支付宝字符集(官方标准值为:UTF-8);

  • ALIPAY_VERSION:支付宝接口版本(常规开放平台API固定值为1.0)。

注意: 每次部署所需的环境变量会根据你的项目需求动态生成,并非固定不变。以上仅为通用示例参数。

2. 配置前提与准备:

  • 账号资质:需具备企业/个体工商户资质(营业执照、法人身份证)及对应的支付宝商家账号(个人账号无法开通线上支付)。

  • 环境准备:需具备已备案的网站域名(用于配置回调地址)及服务器公网IP(用于配置接口白名单)。

  • 产品选择:根据业务场景选择需开通的支付产品(如手机网站支付、APP支付、电脑网站支付、当面付等)。

  • 创建支付应用:

创建应用:登录支付宝开放平台(open.alipay.com),在“控制台”创建网页/移动应用,填写应用名称、图标、类型等信息。

绑定产品:在应用详情页的“产品绑定”中,绑定已开通的支付产品(如手机网站支付),并提交审核。

小程序开发指引:https://opendocs.alipay.com/mini/developer

第三方应用开发指引:https://opendocs.alipay.com/isv

网页&移动应用开发指引:https://opendocs.alipay.com/open

3. 核心配置步骤

3.1 获取APPID

应用提交审核并通过后在应用详情页的应用名称下方,即可查看正式 APPID(一串数字格式的编号)

3.2 密钥生成与配置(核心)

  • 操作入口:

登陆开放平台控制台,选择某个应用,点击 详情,进入 应用详情页 > 开发设置> 开发信息> 接口加签方式(密钥/证书)> 设置。

阅读接口加签方式注意事项,然后点击 确认进入配置流程。

  • 密钥配置流程:

设置加签方式,选择 密钥> 下一步。

  • 生成密钥:

Step1:下载并安装 支付宝开放平台密钥工具。

Step2:打开密钥工具,进入 生成密钥功能。

Step3:加签方式选择 密钥,加签算法选择 RSA2。(开放平台支持 SM2 算法,但暂未公开配置,如有需要请联系支付宝技术支持)

Step4:点击 生成密钥,可以在结果页中看到生成的应用公钥、应用私钥。
说明:RSA2 加密算法默认生成格式为 PKCS8(Java 适用),如需 PKCS1 格式(非 Java 适用),可使用 格式转换。

Step5:复制 应用公钥 字符串。

Step6:返回开放平台控制台中,点击 下一步。

  • 上传公钥:在开放平台“加签管理”页面,上传应用公钥,并获取支付宝公钥(用于验证支付宝回调)。

配置白名单具体操作参考:服务器 IP 白名单

配置回调地址具体操作参考:回调地址

3.3 异步回调地址生成

具体操作参考:支付宝异步通知说明

UXbot让设计无界,“码”上即现

立即体验