Stablecoin Payment for
Your Shopify Store

BitVoyチームにお問い合わせください。以下の情報をご用意いただきます:

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

登録完了後、以下の情報が発行されます:

• OIDC クライアントID / シークレット
• HMAC シークレット
• テーマ埋め込み用スニペット

BitVoyがShopifyの注文を自動作成するために、Admin APIアクセストークンが必要です。 Shopify Dev Dashboard からカスタムアプリを作成し、インストールリンクを使ってストアに導入します。

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

1. Shopify Partners または Shopify Dev Dashboard にログイン
2. アプリ → アプリを作成をクリック
3. アプリ名: BitVoy Payment（任意）
4. Admin APIスコープを設定:
   • write_draft_orders — 下書き注文の作成・完了
   • write_orders — 注文へのメモ・タグ追加

2-2. インストールリンクでストアにインストール

1. Dev Dashboard のアプリ設定画面で 「カスタムインストールリンクを管理」（Distribution → Custom distribution）を開く
2. カスタム配布のインストールリンクをコピー
   （形式: https://admin.shopify.com/oauth/install_custom_app?client_id=...&signature=...）
3. コピーしたリンクをブラウザで開き、対象ストアにインストール
4. インストール完了後に表示される Admin APIアクセストークン（shpat_xxxx...）をコピーしてBitVoyチームに共有

注意: アクセストークンはインストール時に一度だけ表示されます。安全な方法で共有してください。

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>

属性の説明

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

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