Go 模块
在您的 Go 应用中接受加密货币支付
从您的 Go 服务创建加密货币账单并校验签名 Webhook,只需标准库。资金直接进入您自己的钱包。
安装
go get github.com/ArionPay-Dev/arionpay-go功能介绍
面向 Go 开发者的 ArionPay
阅读更多
Webhook 中的账单与 GetInvoice 的结果是同一个 arionpay.Invoice 类型,因此一个函数即可同时处理两者。ArionPay 从不持有资金:款项直接进入您自己的钱包。- 无任何依赖(仅使用标准库)。Go 1.21 或更高版本。
- 每次调用都接受一个 context.Context。取消 context 也会停止重试之间的等待。
- 每个账单请求都带有幂等键,因此网络错误绝不会创建两张账单。
- VerifyWebhook 基于原始请求体校验签名;签名不匹配或超过 5 分钟时,返回 *SignatureError。
- 金额为 arionpay.Amount 类型:即 ArionPay 发送的原样文本,从不四舍五入。inv.Matches("49.90", "USD") 会精确到分地比对订单总额。
- Client 可以在多个 goroutine 之间安全共享。默认 HTTP 客户端的超时时间为 20 秒,且不跟随重定向。
- 借助 SimulatePayment 和 SendTestWebhook,您可以不用真钱进行测试。
要求与许可证
- 适用于
- Go 1.21 或更高版本 · net/http、Gin、Echo、Chi、Fiber · 仅使用标准库
- 费用
- 开发库免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
- 源代码
- 在 GitHub 上开源(MIT)。
设置
5 步完成设置
第 1 步
添加模块
运行 go get github.com/ArionPay-Dev/arionpay-go,并以 arionpay "github.com/ArionPay-Dev/arionpay-go" 的形式导入。
第 2 步
复制您的密钥
在您的 ArionPay 控制台中打开您的店铺,复制 API key(pk_)和 API secret(sk_,复制时需要输入验证器动态码)。Webhook 的 signing secret(whsec_)位于“Webhooks”页面。将它们放在 Config 中传给 arionpay.New。
第 3 步
创建账单
用 Amount、Currency 和 OrderID 调用 client.CreateInvoice(ctx, arionpay.InvoiceParams{...}),然后重定向到 inv.InvoiceURL。
第 4 步
校验 Webhook
在“Webhooks”页面设置您的 Webhook 地址,或用 CallbackURL 为单张账单设置。读取原始请求体,连同 ArionPay-Signature 请求头传给 client.VerifyWebhook,并在收到 invoice.paid 时交付。
第 5 步
不用真钱进行测试
用 Test: arionpay.Bool(true) 和 USDT_TRC20 等 Asset 创建账单,然后调用 client.SimulatePayment(ctx, inv.ID, "exact")。您的 Webhook 会像真实付款一样收到 invoice.paid。
设置完成后
付款如何到达您的代码
- invoice.pending:已在网络上发现付款,正在等待确认。请暂勿交付。
- invoice.paid:已全额支付并确认,或由您在控制台中手动接受。只在收到此事件(或 GetInvoice 返回的 Status 为 "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 Go 开发库的问题
将它加入代码之前需要了解的简短解答。