n8nコミュニティノード
n8nのワークフローで暗号資産決済を受け付け
どのn8nワークフローからでもArionPayの請求書を作成し、支払いが承認されたら独自のステップを実行できます。顧客はご自身のウォレットに直接支払います。ArionPayが資金を預かることはありません。
機能
n8n向けArionPay
続きを読む
「Verify Webhook」は正確なボディに対して署名を検証し、「Invoice Paid」など選んだイベントだけを、それぞれ1回ずつ次に渡します。その後に独自のステップを続けます。たとえば、ファイルを送る、アクセス権を付与する、スプレッドシートで注文を支払い済みにする、などです。- Invoice:請求書を作成して支払いページのアドレスを取得、請求書を取得、またはテスト支払いをシミュレーション。
- 「Verify Webhook」は、正確なボディに対して署名を検証します。時刻の許容幅は5分です。
- ArionPayが同じイベントを再送しても、各イベントは1回だけ次に渡されます。有効なワークフローは、直近300件のイベントIDを記憶します。
- 受け取るイベントを選べるほか、ワークフローでテスト請求書だけ、または本番の請求書だけを扱うこともできます。
- Coin・Rate:ArionPayが受け付けるコインと、コインの価格を一覧表示。
- 「ArionPay API」の認証情報は、n8nのHTTP Requestノードで行うリクエストの署名にも使えます。
- ほかのパッケージは不要:リクエストはNode自体のcryptoで署名されます。
動作要件とライセンス
- 対応環境
- コミュニティノードを使えるn8n · ノードAPIバージョン1(n8n 2.xではまだ未実行)
- 動作確認
- n8n 1.123.96(Node.js 22)
- 費用
- プラグインは無料です。ArionPayの手数料は1回の支払いにつき0.5%で、月額料金はかかりません。
- ソースコード
- GitHubでオープンソース(MIT)として公開。
セットアップ
5つのステップで設定
ステップ1
ノードをインストール
n8nで「Settings > Community Nodes > Install」を開き、n8n-nodes-arionpayと入力して確定します。
ステップ2
認証情報を追加
APIキー、APIシークレット、Webhook署名シークレットを使って「ArionPay API」の認証情報を作成します。「Test」では、何も変更しない署名付きリクエストが1回送信されます。
ステップ3
Webhookノードを追加
「HTTP Method」を「POST」、「Respond」を「When Last Node Finishes」、「Response Data」を「No Response Body」に設定します。「Options」で「Raw Body」を追加してオンにします。
- 4
ステップ4
検証してから独自のステップへ
その後に「ArionPay > Webhook > Verify Webhook」を追加し、受け取るイベントを選びます(初期値は「Invoice Paid」)。続けて独自のステップを追加し、invoice.orderIdまたはinvoice.metadataを使って注文を特定します。
ステップ5
URLを貼り付け
Webhookノードの「Production URL」を、ArionPayダッシュボードの「Webhooks」ページにコピーするか、請求書を作成するたびに「Callback URL」に入れます。最後にワークフローを有効にします。
設定の後
支払いの更新が届く仕組み
- Invoice Paidは、全額が支払われ、承認済みであることを意味します。遅れた支払い、ストアの支払い許容範囲(デフォルトは1%)内の小さな差、Payment Radarで受け付けた支払いも含まれます。
- 金額が正確でない支払いが、ダッシュボードであなたが判断する前に支払い済みとして届くことはありません。
- 検証に失敗した更新(署名シークレットの誤り、署名の誤りや古い署名)はワークフローを失敗させるため、ArionPayは約3日間、後から再送します。
- 選択していないイベントは、200の応答でワークフローを静かに終了します。
- ダッシュボードの「Send test webhook」で送られるイベントは架空の請求書を記述したもので、オンにしない限りスキップされます。
- 商品を届ける前に、invoice.amountFiatとinvoice.currencyを確認し、実際の販売ではinvoice.testがfalseであることも確認してください。
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
n8n向けArionPayに関するよくある質問
インストール前に知っておきたいことを簡潔にお答えします。