设置您的开发环境
熟悉 Stripe CLI 和我们的服务器端 SDK。
您可以通过 Stripe 的服务器端 SDK 和命令行接口 (CLI) 与 Stripe 的 REST API 进行交互。从 Stripe CLI 开始,简化您的开发环境并进行 API 调用。
使用 SDK 可以避免编写样板代码。要开始从您的环境发送请求,请选择一种语言,按照其快速入门指南进行。
Chrome 扩展程序
在本快速指南中,您将安装 Stripe CLI— 这是一种重要工具,可让您通过命令行访问 Stripe 集成。您还需要安装 Stripe .NET 服务器端 SDK,以从用 C# 编写的应用程序访问 Stripe API。
所学内容
本快速指南中,您将学会如何:
- 如何在不编写代码的情况下调用 Stripe API
- 如何用 .NET Core CLI、NuGet CLI 或包管理控制台管理第三方依赖
- 如何安装最新的 Stripe .NET SDK v48.0.0
- 如何发送第一个 SDK 请求
初始设置
首先,创建 Stripe 账户或登录。
设置 Stripe CLI
安装
在命令行中,使用一个安装脚本或为您的操作系统下载并提取一个有版本号的归档文件,完成 CLI 的安装。
验证身份
登录并验证您的 Stripe 用户账户,以生成一组_受限密钥_。要了解更多,请查看 Stripe CLI 密钥和权限。
stripe login
在您的键盘上按 Enter 键,在浏览器中完成验证过程。
Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)
确认设置
现在,CLI 已安装完毕,您可以向 Create a product 发出一个 API 请求。
stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI"
在响应对象中查找产品标识符( id
中)。保存它以备下一步使用。
如果一切正常,命令行将显示以下响应。
{ "id":
, "object": "product","prod_LTenIrmp8Q67sa"
接下来,调用 Create a price,附加一个 30 美元的价格。将 product
中的占位符替换为您的产品标识符(例如,prod_
)。
stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product=
{{PRODUCT_ID}}
如果一切正常,命令行将显示以下响应。
{ "id":
, "object": "price","price_1KzlAMJJDeE9fu01WMJJr79o"
安装 .NET 服务器端 SDK
Stripe .NET 服务器端 SDK 的最新版本是 v48.0.0。它支持 .NET Standard 2.0+、.NET Core 2.0+ 和 .NET Framework 4.6.1+。
检查您的 .NET SDK 的版本:
dotnet --list-sdks
安装库
使用 .NET Core 命令行界面 (CLI) 从命令行新建项目:
dotnet new console
要安装库,运行以下命令,将包引用添加到您的项目文件 (.
) 中:
dotnet add package Stripe.net
用 CLI 安装库后,该库将作为依赖项自动添加到您的项目文件 (.
) 中。例如:
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>net6.0</TargetFramework> <ImplicitUsings>enable</ImplicitUsings> <Nullable>enable</Nullable> </PropertyGroup> <ItemGroup> <PackageReference Include="Stripe.net" Version="48.0.0" /> </ItemGroup> </Project>
备选安装方式
运行您的第一个 SDK 请求
您现在已安装 .NET SDK,可以通过几个 API 请求创建订阅产品并附加价格。在此示例中,我们使用响应中返回的产品标识符来创建价格。
using System; using Stripe; class Program { static void Main(string[] args) { StripeConfiguration.ApiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"; var optionsProduct = new ProductCreateOptions { Name = "Starter Subscription", Description = "$12/Month subscription", }; var serviceProduct = new ProductService(); Product product = serviceProduct.Create(optionsProduct); Console.Write("Success! Here is your starter subscription product id: {0}\n", product.Id); var optionsPrice = new PriceCreateOptions { UnitAmount = 1200, Currency = "usd", Recurring = new PriceRecurringOptions { Interval = "month", }, Product = product.Id }; var servicePrice = new PriceService(); Price price = servicePrice.Create(optionsPrice); Console.Write("Success! Here is your starter subscription price id: {0}\n", price.Id); } }
将代码保存到项目中的 Program.
文件中。从命令行,cd
到包含您刚刚保存的文件的目录,然后运行:
dotnet run
如果一切正常,命令行将显示以下响应。保存这些标识符,以便在构建集成时使用。
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb