Menu
Sections
BitVoy × Shopify

Stablecoin Payment for
Your Shopify Store

ShopifyストアにUSDC / JPYC / USDTなどのステーブルコイン決済を追加。
コード不要 — スニペットを貼るだけで、暗号資産による支払いを即日受付できます。

特長

審査不要・即日導入

Shopify Payments Appの審査は不要。Draft Order方式により、既存の決済フローを邪魔せずにステーブルコイン決済を追加できます。

自動注文作成

決済が完了すると、Shopify管理画面に「支払い済み」の正式注文が自動作成されます。手動操作は不要です。

リアルタイム為替レート

CoinGecko APIを利用し、JPY / USD等の法定通貨価格をリアルタイムでステーブルコインに変換。顧客には常に正確な価格が表示されます。

複数通貨対応

顧客が好みのステーブルコインを選択可能。ストアごとに対応通貨を設定できます。

USDC JPYC USDT

Avalanche & Base 対応

高速・低コストのAvalancheとBaseチェーンに対応。ガス代は通常$0.01以下、確定まで数秒です。

カート自動クリア

決済完了後、Shopifyのカートは自動的にクリアされ、顧客は注文確認ページにリダイレクトされます。


仕組み(Draft Order方式)

BitVoy Shopify連携は、ShopifyのDraft Order APIを利用します。 顧客がステーブルコイン決済を選択すると、裏側でDraft Order(下書き注文)が作成され、 BitVoyでの決済完了後に自動で正式注文に変換されます。

カートページ決済ボタン表示
BitVoyDraft Order作成 + Intent発行
決済ページパスキー認証 + ステーブルコイン送金
注文確定Draft Order → 正式注文(支払い済み)
注文確認ページカート自動クリア + Shopifyへリダイレクト

ポイント


導入手順

1

ストア登録を申請

登録フォームからストア情報を入力してください。登録完了後、セットアップに必要な設定値とスニペットが自動発行されます。

ストア登録フォームへ

登録フォームで入力する情報:

  • Shopifyストアドメイン — 例: mystore.myshopify.com
  • 入金先ウォレットアドレス — ステーブルコインの受取先 (0x...)
  • ストアの法定通貨 — JPY, USD, EUR 等
  • 対応するステーブルコイン — USDC, JPYC, USDT から選択

登録完了後に発行・表示される情報:

  • Shopify Dev Dashboard への入力値(アプリ名・スコープ・URL等)— コピーボタン付きで表示
  • テーマ埋め込み用スニペット
2

Shopify Dev Dashboard でアプリを作成・インストール

BitVoyがShopifyの注文を自動作成するために、Shopify Dev DashboardでカスタムアプリをOAuth接続します。 ストア登録フォーム完了後に表示される設定値をコピーして使用してください。

ℹ️ ストア登録フォームの完了後、以下の手順で必要な設定値がコピーボタン付きで自動表示されます。Dev Dashboardへの入力はコピー&ペーストのみで完了します。

2-1. Dev Dashboard でアプリを作成

  1. Shopify Dev Dashboard にログイン
    管理画面からの導線: 設定 → アプリと販売チャネル → アプリを開発する → Dev Dashboardでアプリを開発
  2. アプリアプリを作成Dev Dashboardから開始 をクリック
  3. アプリ名を入力(登録フォームで表示される値をコピー)
  4. バージョン作成画面で以下を設定:
    • App URL: https://bitvoy.org/shopify/auth
    • リダイレクトURL(2件登録):
      • https://bitvoy.org/shopify/auth/callback
      • https://bitvoy.org/shopify/payment-callback
    • スコープ: write_draft_orders, read_draft_orders, write_orders, read_orders
    • Webhooks APIバージョン: 2026-01
  5. リリース をクリックしてバージョンを確定

2-2. Client ID / Client Secret を登録フォームに入力

  1. Dev Dashboardのアプリ設定画面で Client IDClient Secret をコピー
  2. 登録フォームのセットアップ画面に戻り、コピーした値を貼り付けて 「接続を確認」 をクリック
  3. BitVoyサーバーがOAuth接続を自動検証し、成功すると次のステップがアンロックされます

2-3. ストアにインストール

  1. Dev Dashboardのアプリホーム画面で 「アプリをインストール」 をクリック
  2. インストール先のストアを選択し 「インストール」 を確認
  3. Shopify管理画面でスコープの承認を求められるので 「インストール」 をクリック
⚠️ Dev DashboardのCustom distributionはShopify Plus組織内のストアにのみ配布リンクを送れます。通常ストアへのインストールは上記2-3の手順で直接インストールしてください。
3

テーマにスニペットを埋め込む

Shopifyテーマのカートページ(cart.liquid または main-cart.liquid)に、 登録フォームで発行されたスニペットを貼り付けます。

<!-- BitVoy ステーブルコイン決済ボタン -->
<div id="bitvoy-payment"
     data-shop="{{ shop.permanent_domain }}"
     data-total="{{ cart.total_price | divided_by: 100.0 }}"
     data-shop-currency="{{ shop.currency }}"
     data-currency="USDC"
     data-currencies="USDC,JPYC,USDT"
     data-chain="avalanche">
</div>
<script src="https://bitvoy.org/shopify/button.js" async></script>

属性の説明

属性 説明 値の例
data-shop ストアの永続ドメイン Liquid: {{ shop.permanent_domain }}
data-total カート合計額(法定通貨) Liquid: {{ cart.total_price | divided_by: 100.0 }}
data-shop-currency ストアの法定通貨 Liquid: {{ shop.currency }}
data-currency デフォルトの決済通貨 USDC
data-currencies 選択可能な通貨(カンマ区切り) USDC,JPYC,USDT
data-chain ブロックチェーン avalanche / base
4

テスト決済

設定完了後、以下を確認してください:

  1. カートページにBitVoy決済ボタンが表示される
  2. 通貨セレクターでUSDC / JPYC等を切り替えると、リアルタイムレートが表示される
  3. ボタンクリックでBitVoy決済ページに遷移する
  4. 決済完了後、Shopifyの注文確認ページにリダイレクトされ、カートがクリアされている
  5. Shopify管理画面に「支払い済み」の注文が作成されている(bitvoyタグ付き)

導入手順動画

▶ 導入手順動画を見る(YouTube)

よくある質問

Shopify Payments Appの審査は必要ですか?

いいえ。Draft Order APIを利用するため、Payment App審査は不要です。Shopifyのカスタムアプリ(Admin API)のみ使用します。

既存の決済方法(クレジットカード等)に影響はありますか?

ありません。BitVoyの決済ボタンはカートページに追加されるだけで、Shopifyの標準チェックアウトとは完全に独立しています。

対応しているステーブルコインは?

USDC、JPYC、USDTに対応しています。チェーンはAvalancheとBaseをサポートしており、USDC・USDTはどちらのチェーンでも利用可能です。JPYCはAvalancheのみ対応しています。

為替レートはどのように計算されますか?

CoinGecko APIのリアルタイムレートを使用し、ストアの法定通貨(JPY, USD等)から選択されたステーブルコインへ自動変換します。レートは5分間キャッシュされます。

入金のタイミングは?

顧客がステーブルコインで支払うと、ブロックチェーン上のトランザクション確定後(通常数秒)に、設定した入金先ウォレットアドレスへ直接送金されます。中間の保管はありません。

手数料はかかりますか?

STANDARDモード: 決済額の1.0%(USDC/JPYCはガス代無料、USDTは初回のみ承認ガス代あり)。
AAモード(PREMIUM): ガス代完全無料(弊社負担)。
Avalanche: 0.5% + ¥20/件(JPY) / 0.5% + $0.15/件(USD)
Base: 0.5% + $0.10/件(USD)
最低取引金額: ドル建て $2 / 円建て ¥300

Shopify管理画面ではどのように表示されますか?

通常の注文と同じように表示されます。注文には bitvoy, crypto-payment タグと、Intent ID・トランザクションハッシュがメモとして記録されます。

返品・返金はどうなりますか?

ブロックチェーン上のトランザクションは取り消しできないため、返金はストア側からウォレットアドレスへ手動で送金する形になります。Shopify管理画面上での返金処理は通常通り記録可能です。

導入のご相談

ステーブルコイン決済の導入に興味がありましたら、お気軽にお問い合わせください。