.NET 开发库
在您的 .NET 应用中接受加密货币支付
在 ASP.NET Core 中创建加密货币账单并校验签名 Webhook,全程异步。资金直接进入您自己的钱包。
安装
dotnet add package ArionPay示例
功能介绍
面向 .NET 开发者的 ArionPay
NuGet 上的 ArionPay 是 ArionPay 官方的 .NET 客户端,适用于 .NET 8 或更高版本。它只需要 .NET 本身(HttpClient 和 System.Text.Json),价格使用 decimal,加密货币金额以文本保存,并基于原始请求体校验 Webhook 签名。
阅读更多
每次调用都是异步的,并接受一个 CancellationToken。ArionPay 从不持有资金:款项直接进入您自己的钱包。- 无任何依赖:只需 .NET 本身(HttpClient、System.Text.Json)。.NET 8 或更高版本(8、9、10)。
- 全程异步,每次调用都可传入 CancellationToken。
- 每个账单请求都带有幂等键,因此网络错误绝不会创建两张账单。
- VerifyWebhookAsync 读取请求体并校验签名;签名不匹配或超过 5 分钟时,会抛出 ArionPaySignatureException。
- 金额精确:价格为 decimal,加密货币金额以文本保存。inv.Matches(49.90m, "USD") 会精确到分地比对订单总额。
- 线程安全:将客户端以单例形式注册一次即可。您也可以传入自己的 HttpClient,例如来自 IHttpClientFactory 的实例。
- 借助 SimulatePaymentAsync 和 SendTestWebhookAsync,您可以不用真钱进行测试。
要求与许可证
- 适用于
- .NET 8 或更高版本 · ASP.NET Core Minimal API 和控制器、Worker 服务、控制台应用
- 费用
- 开发库免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
- 源代码
- 在 GitHub 上开源(MIT)。
设置
5 步完成设置
第 1 步
添加软件包
运行 dotnet add package ArionPay。除 .NET 外没有任何依赖。
第 2 步
复制您的密钥
在您的 ArionPay 控制台中打开您的店铺,复制 API key(pk_)和 API secret(sk_,复制时需要输入验证器动态码)。Webhook 的 signing secret(whsec_)位于“Webhooks”页面。请将它们保存在环境变量或 user secrets 中。
第 3 步
注册客户端并创建账单
将一个 ArionPayClient 注册为单例。用 InvoiceRequest(Amount、Currency、OrderId)调用 CreateInvoiceAsync,然后重定向到 invoice.InvoiceUrl。
第 4 步
校验 Webhook
在“Webhooks”页面设置您的 Webhook 地址,或用 CallbackUrl 为单张账单设置。将 request.Body 和 ArionPay-Signature 请求头传给 VerifyWebhookAsync,并在收到 invoice.paid 时交付。
第 5 步
不用真钱进行测试
用 Test = true 和 USDT_TRC20 等 Asset 创建账单,然后调用 SimulatePaymentAsync(inv.Id, "exact")。您的 Webhook 会像真实付款一样收到 invoice.paid。
设置完成后
付款如何到达您的代码
- invoice.pending:已在网络上发现付款,正在等待确认。请暂勿交付。
- invoice.paid:已全额支付并确认,或由您在控制台中手动接受。只在收到此事件(或 GetInvoiceAsync 显示 paid)时交付。返回 SuccessUrl 并不能证明已付款。
- 交付前,请将账单与您的订单核对:您的 OrderId 或 Metadata,以及 inv.Matches(order.Total, order.Currency)。
- invoice.partial、invoice.expired 和 invoice.needs_review 都不代表可以交付。逾期付款仍可能让已过期的账单变为已支付。
- 如果您的服务器没有返回 2xx,ArionPay 会在大约 3 天内重复发送。每个 ev.Id 只处理一次。
9 个网络上的 16 种币和代币
全部币种- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
关于 ArionPay .NET 开发库的问题
将它加入代码之前需要了解的简短解答。
支持。将 Request.Body 和 ArionPay-Signature 请求头传给 VerifyWebhookAsync,并将该 action 排除在防伪(antiforgery)验证之外:调用它的是 ArionPay,而不是浏览器表单。
不要把请求体绑定到模型类:那是经过解析并重新编码的 JSON。请读取原始请求体,或将您已有的字节传给 VerifyWebhook。
可以。将您自己的 HttpClient 作为构造函数的第二个参数传入。它不应跟随重定向。
.NET 8 或更高版本:8、9 和 10。
该开发库免费开源(MIT 许可证)。ArionPay 从预付手续费余额中收取每笔付款的 0.5%,因此全额款项都会到达您的钱包。无月费,无开通费,新账户可获得 $20 手续费额度。