Medusa 2決済プロバイダー
Medusaで暗号資産決済を受け付け
Medusa 2向けの暗号資産決済プロバイダーです。顧客はArionPayのページで、ご自身のウォレットに直接支払います。
インストール
npm install medusa-payment-arionpay例
機能
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
パッケージをインストール
Medusaバックエンドで npm install medusa-payment-arionpay を実行します。
ステップ2
プロバイダーを登録
medusa-config.tsで、medusa-payment-arionpay/providers/arionpayをid arionpayとして決済モジュールに追加します。3つのArionPayキーとバックエンドのアドレスを.envに記載します。
ステップ3
リージョンに追加
Medusaを再起動し、管理画面の「Settings > Regions」を開いて、暗号資産での支払いを提供する各リージョンにArionPay(pp_arionpay_arionpay)を追加します。
ステップ4
ストアフロントを更新
return_url付きで決済セッションを作成し、顧客をsession.data.invoice_urlに送り、戻ってきたらカートを完了します。
ステップ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で動作を確認しています。
はい。ArionPayはリダイレクト型の支払いです。戻り先アドレス付きでセッションを作成し、顧客をArionPayのページに送り、戻ってきたらカートを完了します。READMEのストアフロントの例は、テストで使ったStore APIの呼び出しに沿ったもので、Next.jsのストアフロント内では実行していません。
それでも注文は作成されます。ArionPayの署名付きinvoice.paid Webhookによって、Medusaが支払いをオーソライズし、カートを注文に変えます。
Medusaの返金ボタンで返金が記録されます。暗号資産はご自身のウォレットから送り返してください。
Medusa 2決済プロバイダーは無料のオープンソース(MITライセンス)です。ArionPayは各支払いの0.5%を前払いの手数料残高から差し引くため、全額がウォレットに届きます。月額料金や初期費用はなく、新規アカウントには$20分の手数料クレジットが付与されます。