コンテンツへスキップ
ArionPay

n8n動画ガイド

n8nを暗号資産決済ゲートウェイに接続

どのn8nワークフローからでも暗号資産の請求書を作成し、支払いが承認されたら独自のステップを実行できます。3分足らずの動画で設定の全体を確認し、6つのステップに沿って進めましょう。顧客はご自身のウォレットに直接支払います。

動画を見る(2:28)無料で始める

n8nで「Settings › Community Nodes › Install」を開き、次を入力します

n8n-nodes-arionpay
例

動作を見る

n8nとArionPay:インストールから支払い済みの注文まで

ノードをインストールし、キーを接続して、署名付きの支払いの更新を受け取り、偽造された更新が拒否される様子を確認します。チャプターを選ぶと、その場面に移動します。

セルフホストのn8n 1.123.96とローカルのArionPayテストサーバーを使い、テストモードでワンテイクで録画しました。実際のお金は使っていません。音声はなく、字幕は映像内にあり、すべてのステップは下に書き出しています。

始める前に

必要なもの

  • ArionPayアカウント:登録に必要なのはメールアドレスだけです。無料で作成。
  • コミュニティノードを許可しているセルフホストのn8n。n8n 1.123.96(Node.js 22)でテスト済みで、n8n 2.xではまだテストしていません。
  • ArionPayダッシュボードで取得する、APIキー、APIシークレット、Webhook署名シークレット。
  • 本番の支払いには、ダッシュボードで接続したご自身のウォレット。テスト請求書には実際のお金は不要です。

ステップごとの手順

6つのステップでn8nをArionPayに接続

  1. 1

    ノードをインストール

    n8nで「Settings › Community nodes」を開き、「Install」をクリックします。n8n-nodes-arionpayと入力し、コミュニティコードに関する注意事項を確認して、インストールします。

    n8nがnpmからパッケージをダウンロードし、ArionPayというノードを1つ追加します。このパッケージには他の依存関係はありません。

    n8nのSettings › Community nodes:n8n-nodes-arionpayバージョン2.0.0がインストールされ、ArionPayノードが1つある画面
  2. 2

    API認証情報を追加

    「ArionPay API」タイプの認証情報(credential)を作成し、ArionPayダッシュボードのAPIキー、APIシークレット、Webhook署名シークレットを貼り付けます。「ArionPay Address」はそのまま(https://merchant.arionpay.com)にしておきます。

    保存すると、n8nは何も変更しない署名付きリクエストを1回送ってキーをテストします。動画では、まず誤ったシークレットが拒否され、次に正しいシークレットで「Connection tested successfully」と表示されます。

    n8nのArionPayアカウントの認証情報。APIキー、APIシークレット、Webhook署名シークレットが入力され、「Connection tested successfully」と表示されている
  3. 3

    支払いを受け取るワークフローを作成

    n8n標準のWebhookノードを追加します。HTTP Methodは「POST」、Respondは「When Last Node Finishes」、Response Dataは「No Response Body」にし、Optionsで「Raw Body」を追加してオンにします。

    その後に「ArionPay › Webhook › Verify Webhook」を追加し、必要なイベント(デフォルトはInvoice Paid)を選びます。続けて、ファイルの送信、アクセス権の付与、注文の支払い済み処理など、独自のステップを追加します。

    ワークフローを有効にし、WebhookノードのProduction URLをArionPayダッシュボードのWebhooksページにコピーするか、各請求書のCallback URLとして送信します。

    有効なn8nワークフロー:Webhook、Verify ArionPay webhook、Mark order as paidの順
  4. 4

    テスト請求書を作成して支払う

    どのワークフローでも、「ArionPay › Invoice › Create」で請求書を作成できます。金額と通貨を指定し、Test Invoiceをオンにして、Additional Fieldsでコイン、注文ID、コールバックURLを指定します。

    ArionPayは、支払いページ(invoiceUrl)を含む請求書を返します。そこが顧客を誘導する先です。テストモードでは、「ArionPay › Invoice › Simulate Test Payment」で架空のお金を使って支払えます。

    n8nのArionPay Create invoiceノード:25 USD、テスト請求書、コインはTRON上のUSDT。出力に新しい請求書とそのinvoiceUrlが表示されている
  5. 5

    支払い済みのWebhookが届く

    ArionPayはinvoice.paidの更新に署名して、ワークフローに送信します。Verify Webhookがそれを検証し、ArionPayが再配信した場合でも、次へ渡すのは1回だけです。

    次のステップには必要な情報がすべて揃っています。注文はinvoice.orderId、支払われた金額はinvoice.amountFiatとinvoice.currency、コインはinvoice.paidCryptoとinvoice.asset、ブロックチェーンのトランザクションはinvoice.transactions[0].txidで確認できます。動画では、Setノードが注文ORDER-1001を支払い済みにしています。

    支払い済みWebhook受信後のn8n:左に検証済みのinvoice.paidイベントがあり、注文ORDER-1001が25 USDTとトランザクションIDとともに支払い済みになっている
  6. 6

    偽造されたWebhookは拒否される

    Webhookのアドレスは公開されているため、誰でもでっち上げの「invoice.paid」を送信できます。Verify Webhookは、署名シークレットを使って本文そのものに対するHMAC署名を検証し、タイムスタンプも確認します。

    動画では、誤った署名の偽造された更新が、Verify Webhookで「Invalid signature」として止められます。その後のステップは実行されず、注文は支払い済みになりません。

    n8nが偽造されたWebhookをVerify ArionPay webhookで止め、エラー「Not a valid ArionPay webhook: Invalid signature」を表示している

設定の後

支払いの更新が届く仕組み

  • Invoice Paidは、全額が支払われ、承認済みであることを意味します。遅れた支払い、ストアの支払い許容範囲(デフォルトは1%)内の小さな差、Payment Radarで受け付けた支払いも含まれます。
  • 金額が正確でない支払いが、ダッシュボードであなたが判断する前に支払い済みとして届くことはありません。
  • 検証に失敗した更新(署名シークレットの誤り、署名の誤りや古い署名)はワークフローを失敗させるため、ArionPayは約3日間、後から再送します。
  • 選択していないイベントは、200の応答でワークフローを静かに終了します。
  • ダッシュボードの「Send test webhook」で送られるイベントは架空の請求書を記述したもので、オンにしない限りスキップされます。
  • 商品を届ける前に、invoice.amountFiatとinvoice.currencyを確認し、実際の販売ではinvoice.testがfalseであることも確認してください。

ArionPayを選ぶ理由

得られるもの

ご自身のウォレットに入金

顧客はあなたのウォレットに直接支払います。ArionPayは資金を預からないため、出金する残高もありません。

署名付きの更新を自動で検証

Verify Webhookはすべての支払いの更新を検証し、各イベントを1回だけ次へ渡します。偽造されたリクエストや再送(リプレイ)されたリクエストはそこで止まります。

まずはテストモードで

テスト請求書と架空の支払いでワークフロー全体を作成して試してから、本番に切り替えます。

次のステップは自由

顧客へのメール送信、シートへの行の追加、アクセス権の付与、チャットへの投稿など、n8nでできることなら何でも可能です。ArionPayの手数料は1回の支払いにつき0.5%です。

このノードはオープンソース(MIT)です。 GitHubのソースコード 動画をダウンロード(6.6 MB)

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に関する質問

n8n Cloud、テスト、コイン、費用について。

まだ使えません。n8n Cloudで提供されるのはn8nが検証したコミュニティノードだけで、ArionPayノードは検証を申請済みです。それまでは、どのコミュニティノードもインストールできるセルフホストのn8nをお使いください。