ezPayで電子インボイスを発行する

概要

ezPay電子インボイスは、台湾のNewebPayグループが提供する電子インボイス付加価値サービスプラットフォームです（台湾に「ビジネス拠点」があり、「ストア通貨」が台湾ドル（TWD）であるストアが対象です）。

Kanorioでは、ezPay電子インボイスとの連携は決済ゲートウェイから独立しています。お客様がPAYUNi、SHOPLINE Payments、LINE Pay、JKO Payのいずれで支払った場合でも、支払いや返金が完了すると、システムが自動的にezPayのインターフェースを呼び出し、インボイスの発行、取り消し、またはアローワンス（売上戻し）を完了します。

---

ezPay管理画面での3つの必須準備（よくあるトラブルを回避する）

ezPayを連携する際、「認証情報の接続テストは成功するが、最初のインボイス発行で失敗する」という問題に遭遇する加盟店様が多くいらっしゃいます。Kanorioにキーを入力する前に、ezPay電子インボイスプラットフォームで以下の3つの手順が完了していることを確認してください。

1. 「料金プランの申請」を行い、契約を有効化する（最も見落としやすい！）

接続テストは成功するのに、なぜ発行が失敗するのか（エラーコード INV90005）？ ezPayの「クエリAPI（接続テストに使用）」は契約状況を確認しませんが、「発行API」は料金プランを申請済みかどうかを厳格に検証します。この手順が完了していない場合、実際の発行時にシステムは INV90005（契約が無効または期限切れ） を返します。

• ezPay電子インボイス管理画面にログインし、「インボイス管理 › 管理設定 › 利用状況 › 料金プラン申請」へ進み、適切なプランを選択して申請を提出してください。ステータスが「有効」になっていることを確認します。

2. 財政部（MOF）の承認と「インボイス番号（Track Number）の設定」を完了する

1. 財政部電子インボイス統合サービスプラットフォームにて、ビジネス証明書を使用して、ezPayが電子インボイスの番号サービスを処理できるように承認します。
2. ezPay管理画面に戻り、「インボイス管理 › 管理設定」で「新規番号のダウンロード承認」と「未使用の空白番号の自動アップロード」を有効にするか、「インボイス番号設定」へ進み、現在の隔月期間に利用可能な番号があることを確認します。

3. 加盟店ID（Merchant ID）と32文字の HashKey / 16文字の HashIV をコピーする

1. ezPay管理画面で、「ストア管理 › 詳細」へ進みます。
2. 以下の3つのフィールドの本番環境情報をコピーします（注意：ezPayのテスト環境 cinv.ezpay.com.tw と本番環境 inv.ezpay.com.tw は独立した2つのシステムです。キーに互換性はないため、必ず本番環境 inv.ezpay.com.tw のキーを使用してください）。
   • MerchantID
   • HashKey（AES-256用の32文字の英数字）
   • HashIV（16文字の英数字）

---

KanorioでezPayインボイスを連携・有効化する手順

1. 認証情報を入力し、接続を確認する

1. Kanorio管理画面の「ストア設定 › インボイス」へ進みます。
2. 「ezPay電子インボイス」カードの「認証情報を設定」（または「有効化」）をクリックします。
3. 8桁の統一発票番号（Business Tax ID）、MerchantID、32文字の HashKey、16文字の HashIV を入力します。
4. 「保存」をクリックします。システムが直ちに接続テストを送信し、キーを検証します。検証が完了すると、キーはGoogle Cloud KMSエンベロープ暗号化を使用して安全に保存されます（を参照）。

2. 「インボイス管理」でezPayを有効にする

右上の「インボイス管理」ボタンをクリックし、ezPay電子インボイス を「有効」セクションにドラッグして保存します。これにより、公開中のチェックアウトページに即座に反映されます。

---

お客様のチェックアウト体験と注文の「インボイス」タブ

1. チェックアウト時のインボイスオプション：
   • 個人用クラウドインボイス（デフォルトのezPay会員キャリア、モバイルバーコード、共通キャリア）、寄付（919 Genesis、7585 Children Are Us、25885 Taiwan Fund for Children and Familiesを含む）、および統一発票番号付きの法人インボイスをサポートしています。
   • お客様が8桁の統一発票番号を入力すると、システムが自動的に経済部のデータベースを照会し、「会社名」と「会社住所」を自動入力します（ezPayでは、PrintFlag=Y の法人インボイスの場合、購入者の住所が必要です）。
2. 自動発行、取り消し、および即時アローワンス確認：
   • インボイスは支払い完了後5分以内に自動発行されます。返金時には、台湾の隔月申告ルールに基づき、システムが自動的に取り消しまたはアローワンスを実行します（ezPayのアローワンスは Status=1 の即時確認モードを使用するため、購入者による手動確認は不要です。詳細はを参照）。
3. 注文の「インボイス」タブでインボイスを確認する：
   • 「注文」へ進み、注文を開いて「インボイス」タブに切り替えます。「インボイス情報をコピー / アローワンス情報をコピー」をクリックするか、「インボイスを表示」をクリックしてezPayの公式インボイス照会ページに直接ジャンプし、インボイスの証明を確認できます。

---

よくある発行失敗のトラブルシューティング

関連ドキュメント