活用例
プラグインなしでオンラインストアに暗号資産決済を導入する
オンラインストアは、REST APIで注文ごとに1つの請求書を作成し、顧客をその請求書のホスト型チェックアウトページへ送ることで、Crypto Merchantで暗号資産を受け付けます。顧客はコインを選び、その請求書用に固定されたレートで正確な金額を支払い、署名付きのinvoice.paid Webhookが届いたらサーバーが注文を発送します。手数料は支払い済みの請求書1件につき1%です。WooCommerce、Shopify、Magentoのプラグインはありません。連携は1回のAPI呼び出しと1つのWebhookエンドポイントです。
更新日：2026年11月6日
このページの内容はすべて、APIリファレンス、チェックアウトのドキュメント、料金に記載されている、現在のCrypto Merchantの仕組みを説明したものです。他のゲートウェイについての主張は含まれていません。
概要
| 項目 | 仕組み |
|---|---|
| 顧客の支払い方法 | ホスト型の請求書ページで、あなたが受け付けるコインとネットワークから選び、正確な金額と、その請求書用に発行された入金アドレスを、QRコードとカウントダウンとともに確認します。 |
| 構築するもの | 顧客が暗号資産を選んだときの1回のPOST /invoices呼び出しと、Webhook用の1つのHTTPSエンドポイント。HTTPSリクエストを送れる言語やフレームワークであれば何でも使えます。 |
| 発送のタイミング | 決済が承認を得た後のinvoice.paidイベントで発送します。invoice.confirmingで発送してはいけません。 |
| 金額の過不足 | 不足額が許容額以内の支払いは支払い済みとして扱われます。それより大きな不足があると請求書はunderpaidになり、顧客は不足分を追加で送るか、送金した分を取り戻すことができます。過払いも支払い済みとして扱われ、超過分は顧客のために保持されます。 |
| 価格設定の通貨 | デフォルトは米ドルで、EUR、GBP、TRY、BRLなど他の対応通貨も使えます。コイン建ての金額は、顧客がコインを選んだ時点のライブ価格から計算されます。 |
| プラグイン | ありません。以下の流れは、APIを呼び出せるカートやカスタムのチェックアウトであれば何でも使えます。 |
手順ごとの流れは？
顧客が「暗号資産で支払う」を選んだ瞬間から、注文が倉庫から出るまで：
- 1
チェックアウト時に請求書を作成する
顧客が暗号資産を選んだら、サーバーが
POST /invoicesを呼び出します。注文の合計額、あなたのorder_id、顧客のメールアドレス、サンクスページへ戻るredirect_url、そして返してほしい任意のmetadataを渡します。レスポンスはcheckout_urlを含む請求書です。 - 2
顧客を請求書ページへ送る
checkout_urlにリダイレクトします。このページにはあなたが受け付けるコインが一覧表示され、顧客がコインを選ぶと、そのコイン建ての金額がライブ価格から計算されて固定され、この請求書用に発行された入金アドレスがQRコードとともに表示されます。請求書はあなたが設定した時間（デフォルトは30分）開いたままになります。 - 3
署名付きWebhookを受け取る
エンドポイントには、決済がオンチェーンで検出されたときに
invoice.confirmingが、十分な承認を得たときにinvoice.paidが届きます。CM-Signatureヘッダーを検証し、イベントを保存し、10秒以内に2xxを返してから、保存した内容に基づいて注文を処理します。イベントは2回届くことがあるため、イベントのidを使って発送が1回だけになるようにしてください。 - 4
3つの例外ケースに対応する
invoice.expired：期限内に支払いが届かなかったので、新しい請求書を提示します。invoice.underpaid：顧客は残りを同じアドレスに送るか、請求書ページから返金を受けられます。過払いの請求書も支払い済みであり、超過分は顧客のために保持され、顧客は請求書ページから引き出せます。 - 5
出金する
承認された決済は1%を差し引いて残高に計上され、ビジネスのプールウォレットに集約されます。いつでもご自身のアドレスへ、コインごとにそのまま、またはすべてを1つの保有コインにスワップして出金できます。
必要なのはこの1回のAPI呼び出しだけ
curl https://cryptomerchant.online/api/v1/invoices \
-H "Authorization: Bearer $CM_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": "64.00",
"currency": "USD",
"order_id": "ORD-20931",
"description": "Order ORD-20931",
"customer_email": "[email protected]",
"redirect_url": "https://yourstore.example/orders/20931/thanks",
"metadata": { "cart": "20931" }
}'
# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.費用はいくらですか？
支払い済みの各請求書の1%が、決済が残高に計上される際に差し引かれます。初期費用も月額料金もなく、有効化のための支払いもありません。期限切れやキャンセルされた請求書に費用はかかりません。コインの移動（集約、スワップ、出金）にはガス手数料がかかり、ガス残高を追加している場合はそこから、そうでない場合は移動するコインから差し引かれます。顧客も請求書ごとにガス手数料を支払います。この手数料は送金額に加算され、チェックアウト画面に表示され、$5を超えることはありません。スワップのレートには1%のサービスマージンが含まれます。すべての費用は料金の1つの表にまとめられています。
この場面でCrypto Merchantが行わないこと
- ショッププラグインはありません。WooCommerce、Shopify、Magento、PrestaShop、OpenCartのモジュールはありません。API呼び出しをご自身で追加するか、チェックアウトページと決済リンクを共有します。
- 自動返金はなく、APIに返金の呼び出しもありません。承認された暗号資産決済は確定のため、返金は新たな送金になります。返品の場合は、管理者がポータルで支払い済みの決済からプライベートな返金リンクを作成します。顧客が自分のアドレスを入力し、ネットワーク手数料は返金額から差し引かれ、1%の手数料は返還されません。
- カストディアル型で、暗号資産のみです。出金までCrypto Merchantが鍵を保管し、出金先は銀行口座ではなく、ご自身のウォレットアドレスです。
どんな方に向いていますか？
- すでに自社でチェックアウトを運用しており、1回のAPI呼び出しとWebhookを追加できるストア。
- カードの入手が難しい国や、チャージバックの被害が大きい国の顧客に販売しているストア。
- ドル建てで価格を設定し、USDTやUSDCで精算したいストア。
よくある質問
Crypto MerchantにWooCommerceやShopifyのプラグインはありますか？
暗号資産決済が承認されるまでどれくらいかかりますか？
顧客が誤った金額を支払った場合はどうなりますか？
顧客にCrypto Merchantのアカウントは必要ですか？
注文の価格をユーロや他の通貨で設定できますか？
関連ページ
- プラグインなしでShopifyで暗号資産を受け付ける
- プラグインなしでWooCommerceで暗号資産を受け付ける
- APIリファレンス
- Webhook
- 支払い不足と過払いの決済
- おすすめの暗号資産決済ゲートウェイ
- 料金と手数料
その他の活用例
今日から暗号資産決済を始めましょう
初期設定無料、登録時の書類提出不要、支払い済みの請求書1件につき1%、出金はいつでも好きなときに行えます。