Goモジュール
Goアプリで暗号資産決済を受け付け
Goのサービスから暗号資産の請求書を作成し、標準ライブラリだけで署名付きWebhookを検証します。資金はご自身のウォレットに直接届きます。
インストール
go get github.com/ArionPay-Dev/arionpay-go機能
Go開発者向けArionPay
続きを読む
Webhookの請求書とGetInvoiceの結果は同じarionpay.Invoice型なので、1つの関数で両方を処理できます。ArionPayが資金を預かることはありません。資金はご自身のウォレットに直接届きます。- 依存関係なし(標準ライブラリのみ)。Go 1.21以降。
- すべての呼び出しでcontext.Contextを受け取ります。コンテキストがキャンセルされると、再試行の間の待機も止まります。
- 請求書の各リクエストには冪等キー(idempotency key)が付くため、ネットワークエラーで請求書が二重に作成されることはありません。
- 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の手数料は1回の支払いにつき0.5%で、月額料金はかかりません。
- ソースコード
- GitHubでオープンソース(MIT)として公開。
セットアップ
5つのステップで設定
ステップ1
モジュールを追加
go get github.com/ArionPay-Dev/arionpay-go を実行し、arionpay "github.com/ArionPay-Dev/arionpay-go" としてインポートします。
ステップ2
キーをコピー
ArionPayダッシュボードでストアを開き、APIキー(pk_)とAPIシークレット(sk_。認証アプリのコードが求められます)をコピーします。Webhook署名シークレット(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は1回だけ処理してください。
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ライブラリに関するよくある質問
コードに組み込む前に知っておきたいことを簡潔にお答えします。