コンテンツへスキップ
ArionPay

.NETライブラリ

.NETアプリで暗号資産決済を受け付け

ASP.NET Coreから暗号資産の請求書を作成し、署名付きWebhookを検証します。処理はすべて非同期です。資金はご自身のウォレットに直接届きます。

インストール

dotnet add package ArionPay
GitHubのソースコード
例

機能

.NET開発者向けArionPay

NuGetのArionPayは、.NET 8以降向けのArionPay公式クライアントです。.NET本体(HttpClientとSystem.Text.Json)以外は何も必要とせず、価格をdecimalで、暗号資産の金額をテキストで保持し、生のボディでWebhook署名を検証します。
続きを読むすべての呼び出しは非同期で、CancellationTokenを受け取ります。ArionPayが資金を預かることはありません。資金はご自身のウォレットに直接届きます。
  • 依存関係なし:.NET自体(HttpClient、System.Text.Json)のみ。.NET 8以降(8、9、10)。
  • すべて非同期で、すべての呼び出しでCancellationTokenを受け取ります。
  • 請求書の各リクエストには冪等キー(idempotency key)が付くため、ネットワークエラーで請求書が二重に作成されることはありません。
  • VerifyWebhookAsyncはリクエストのボディを読み取って署名を検証し、一致しない場合や5分以上前のものである場合はArionPaySignatureExceptionをスローします。
  • 正確な金額:価格はdecimal、暗号資産の金額はテキストで保持します。inv.Matches(49.90m, "USD")は、注文の合計をセント単位まで比較します。
  • スレッドセーフ:クライアントはシングルトンとして一度だけ登録します。IHttpClientFactoryから取得したものなど、独自のHttpClientを渡すこともできます。
  • SimulatePaymentAsyncとSendTestWebhookAsyncを使えば、実際のお金を使わずにテストできます。

動作要件とライセンス

対応環境
.NET 8以降 · ASP.NET CoreのMinimal APIとコントローラー、ワーカーサービス、コンソールアプリ
費用
ライブラリは無料です。ArionPayの手数料は1回の支払いにつき0.5%で、月額料金はかかりません。
ソースコード
GitHubでオープンソース(MIT)として公開。

セットアップ

5つのステップで設定

  1. ステップ1

    パッケージを追加

    dotnet add package ArionPay を実行します。.NET以外の依存関係はありません。

  2. ステップ2

    キーをコピー

    ArionPayダッシュボードでストアを開き、APIキー(pk_)とAPIシークレット(sk_。認証アプリのコードが求められます)をコピーします。Webhook署名シークレット(whsec_)は「Webhooks」ページにあります。環境変数かユーザーシークレットに保管してください。

  3. ステップ3

    クライアントを登録して請求書を作成

    ArionPayClientを1つシングルトンとして登録します。InvoiceRequest(Amount、Currency、OrderId)を指定してCreateInvoiceAsyncを呼び出し、invoice.InvoiceUrlにリダイレクトします。

  4. ステップ4

    Webhookを検証

    「Webhooks」ページでWebhookアドレスを設定するか、請求書ごとにCallbackUrlで指定します。request.BodyとArionPay-SignatureヘッダーをVerifyWebhookAsyncに渡し、invoice.paidで商品を提供します。

  5. ステップ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は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 .NETライブラリに関するよくある質問

コードに組み込む前に知っておきたいことを簡潔にお答えします。

はい。Request.BodyとArionPay-SignatureヘッダーをVerifyWebhookAsyncに渡し、そのアクションを偽造防止(antiforgery)の検証から除外してください。呼び出すのはブラウザのフォームではなく、ArionPayです。

開発者向けライブラリ