コンテンツへスキップ
ArionPay

Medusa 2決済プロバイダー

Medusaで暗号資産決済を受け付け

Medusa 2向けの暗号資産決済プロバイダーです。顧客はArionPayのページで、ご自身のウォレットに直接支払います。

インストール

npm install medusa-payment-arionpay
GitHubのソースコード
例

機能

Medusa向けArionPay

medusa-payment-arionpayは、Medusa 2向けの暗号資産決済プロバイダーです。ストアフロントが顧客をArionPayのページに移動させ、資金はご自身のウォレットに直接届きます。ArionPayが資金を預かることはありません。
続きを読むArionPayが全額の支払いを承認すると、その署名付きWebhookによってMedusaが決済セッションをオーソライズし、カートを注文に変えます。顧客が戻ってこなくても同様です。独自のMedusaバックエンドとストアフロントを運用している開発者向けのパッケージです。
  • npmでmedusa-payment-arionpayとして公開。Medusa本体以外の依存関係はありません。
  • 署名付きのinvoice.paid Webhookがカートを注文に変えます。顧客が戻ってこなくても同様です。
  • ストアフロントがカートを完了するときにプロバイダーがArionPayへ直接確認するため、届かなかったWebhookも検出できます。
  • セッションが支払い済みとみなされるのは、ArionPay自身が同じ金額、通貨、モードの請求書を承認した場合だけです。
  • カートが変わると、次のセッションでは新しい合計に合わせた新しい請求書が作成されます。
  • 暗号資産の支払いは確定的なため、支払いは即座にキャプチャされます。
  • testModeはfalseに設定しない限りオンのため、設定漏れで実際のお金を受け取ってしまうことはありません。
例

動作要件とライセンス

対応環境
Medusa 2 · Node 20以降
動作確認
Medusa 2.22.7、Node 22、PostgreSQL 16:Store API経由の21項目のチェックと、7件のユニットテスト
費用
プラグインは無料です。ArionPayの手数料は1回の支払いにつき0.5%で、月額料金はかかりません。
ソースコード
GitHubでオープンソース(MIT)として公開。

セットアップ

5つのステップで設定

設定:medusa-config.tsと.env、次にMedusa管理画面の「Settings > Regions」
  1. ステップ1

    パッケージをインストール

    Medusaバックエンドで npm install medusa-payment-arionpay を実行します。

  2. ステップ2

    プロバイダーを登録

    medusa-config.tsで、medusa-payment-arionpay/providers/arionpayをid arionpayとして決済モジュールに追加します。3つのArionPayキーとバックエンドのアドレスを.envに記載します。

  3. ステップ3

    リージョンに追加

    Medusaを再起動し、管理画面の「Settings > Regions」を開いて、暗号資産での支払いを提供する各リージョンにArionPay(pp_arionpay_arionpay)を追加します。

  4. ステップ4

    ストアフロントを更新

    return_url付きで決済セッションを作成し、顧客をsession.data.invoice_urlに送り、戻ってきたらカートを完了します。

  5. ステップ5

    テストしてから本番へ

    架空のお金を使うテストモードは、ARIONPAY_TEST_MODEをfalseに設定するまでオンのままです。ArionPayのストア設定で「Old ArionPay (v1) integration compatibility」がオフになっていることを確認してください。

設定の後

注文ステータスの変化

  • ArionPayが全額の支払いを承認すると、その署名付きWebhookによってMedusaが決済セッションをオーソライズし、カートを注文に変えます。
  • 暗号資産の支払いは確定的なため、支払いは即座にキャプチャされます。
  • ストアフロントがカートを完了するとき、プロバイダーがArionPayに直接確認します。すでに注文になっているカートの場合は、その注文が返されます。
  • セッション作成後にカートが変わった場合、次のセッションでは新しい合計に合わせた新しい請求書が作成されます。
  • 金額が正確でない支払いはPayment Radarに送られます。ストアの支払い許容範囲(初期値1%)内の小さな差は自動で受け付けられ、それ以外はあなたが判断します。遅れた支払いでも注文は完了します。
  • セッションデータには、支払われた請求書、コイン、paid_lateやunderpaid_within_toleranceなどのメモが記録されます。

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

Medusa向けArionPayに関するよくある質問

インストール前に知っておきたいことを簡潔にお答えします。

Medusa 2です。Medusa 2.22.7、Node 22、PostgreSQL 16で動作を確認しています。