开发者 API

与……集成 URL方案

从您的应用或网站启动 Stripe 付款，以处理交易。传递客户数据、金额和产品信息——然后在交易完成后处理回调。

工作原理

您的应用打开 支付：// 带参数的 URL

Stripe支付系统启动并处理交易

完成后，应用程序会将用户重定向到回调 URL 并显示结果。

终点

创建收费

payment://new?

处理一次性付款，包括金额、币种和描述。

参数

姓名	类型	必需的	描述
`amount`	integer	是的	金额以美分为单位（例如，1000 = 10.00 美元）
`currency`	string	不	三字母 ISO 货币代码（默认值：USD）
`description`	string	不	URL编码的费用描述
`customer`	string	不	现有 Stripe 客户 ID
`email`	string	不	客户通过电子邮件索取收据
`name`	string	不	URL编码的客户名称
`metadata`	string	不	自定义键值对（URL编码的JSON）
`callback`	string	不	完成后返回的 URL
`autoprocess`	boolean	不	跳过主屏幕，立即开始充电

创建发票

payment://cart?

创建包含产品目录中各项商品的 Stripe 发票。

参数

姓名	类型	必需的	描述
`prices`	string	是的	以逗号分隔的价格 ID 和数量（例如，price_abc:2,price_xyz:1）
`customer`	string	不	现有 Stripe 客户 ID
`email`	string	不	客户通过电子邮件索取收据
`name`	string	不	URL编码的客户名称
`callback`	string	不	完成后返回的 URL

处理回调

交易完成后，Stripe 付款会将您重定向到回调 URL，并带有指示结果的查询参数。

回调参数

范围	价值观	描述
`status`	success \| error \| cancelled	交易结果
`charge_id`	string	Stripe 付款 ID（成功时）
`error`	string	错误信息（出错时）

示例

简单收费

仅需支付 10 美元即可收取 10.00 美元

payment://new?amount=1000

指控及描述

收费 25.00 欧元，并附有说明

payment://new?amount=2500&currency=eur&description=Coffee%20and%20pastry

向新客户收费

收取 50.00 美元并创建客户记录

payment://new?amount=5000&name=John%20Smith&[email protected]

向现有客户收费

向现有 Stripe 客户收取 75.00 美元

payment://new?amount=7500&customer=cus_ABC123xyz

元数据收费

添加自定义元数据，记录收费 100 美元。

payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7D

自动处理回调

完成后跳过主屏幕，直接返回应用。

payment://new?amount=3500&autoprocess=true&callback=myapp://payment-complete

包含明细项目的发票

使用 Stripe 目录中的产品创建发票

payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]

完整示例

所有参数综合起来形成完全集成流

payment://new?amount=15000&currency=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-result

URL编码

请记住对参数值中的特殊字符进行 URL 编码。空格会编码为 %20，花括号会编码为 %7B 和 %7D。

准备好整合了吗？

下载应用，立即开始测试集成功能。

下载该应用联系客服