> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouquet-inc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 「チェックアウト住所バリデーター」と連携する

> お客様が振り分け画面で追加・編集したお届け先の住所を、チェックアウトと同じルールとエラーの文で確かめる設定です。

Flatto Inc.の「[チェックアウト住所バリデーター](https://apps.shopify.com/checkout-address-validator?locale=ja)」と連携すると、お客様が振り分け画面でお届け先を追加・編集して「**登録する**」を押したときに、チェックアウトと同じ住所のルールとエラーの文で住所を確かめます。郵便番号と都道府県の食い違いや番地の抜けを、ご注文の前にお客様に直していただけます。

> [!NOTE]
>
> 「チェックアウト住所バリデーター」を入れているだけでは、お届け先ごとの住所は確かめられません。決済画面で確かめられるのは、親注文の配送先1件だけです。お届け先ごとの住所（子注文の配送先）を確かめるには、この連携が必要です。

どのプランでもお使いいただけます。

## 確かめる場面

| 場面 | 確かめるか |
| - | - |
| 振り分け画面で「**配送先を追加する**」から住所を入れて「**登録する**」を押したとき | 確かめる |
| 住所帳の住所を「**編集**」して「**登録する**」を押したとき | 確かめる |
| 住所帳にもともとある住所をそのまま選んだとき | 確かめない |
| 電話番号 | 確かめない（MultiGiftsの桁数のチェックだけ） |

## 設定の手順

**1. 「チェックアウト住所バリデーター」を入れて、ルールを設定する**

[Shopify App Store](https://apps.shopify.com/checkout-address-validator?locale=ja)からインストールし、バリデーションのルールとエラーの文を設定します。チェックアウトで使っているルールとエラーの文が、そのままお届け先の確認にも使われます。

**2. APIキーを発行する**

「チェックアウト住所バリデーター」の「**設定**」→「**API連携**」で「**APIキーを発行**」を押し、表示された**APIキー**（`pk_` で始まる値）と**シークレット**（`sk_` で始まる値）を控えます。シークレットは発行したときにしか表示されません。

![「チェックアウト住所バリデーター」の「設定」の「API連携」。APIキーとシークレットの欄と、「再発行」「無効化」のボタン（発行済みの状態）](https://mintcdn.com/bouquet-inc/dFtGjgK3bRjAr3qh/images/multigifts/address-validator-api-key.jpg?fit=max\&auto=format\&n=dFtGjgK3bRjAr3qh\&q=85\&s=5e877ed4da7a810dff12b1223ecc7d2f)

**3. MultiGiftsにAPIキーとシークレットを登録する**

MultiGiftsのメニューの「**連携アプリ**」を開き、「**API キー**」と「**シークレット**」を入れて「**保存**」を押します。保存するときに見本の住所で1回確かめ、「**連携の状態**」が「**連携中**」になります。

![MultiGiftsの「連携アプリ」。「連携の状態」が「連携中」で、APIキーとシークレットの欄がある](https://mintcdn.com/bouquet-inc/dFtGjgK3bRjAr3qh/images/multigifts/address-validator-admin.jpg?fit=max\&auto=format\&n=dFtGjgK3bRjAr3qh\&q=85\&s=2a724f4bdfd5e2c35a8c1cf421dc9b0f)

APIキーかシークレットが正しくないときは保存されず、「API キーかシークレットが正しくありません」と表示されます。発行した値を入れ直してください。

**4. ストアで確かめる**

ストアのカートで「**複数のお届け先に送る**」→「**配送先を追加する**」を開き、わざと誤った住所（例: 郵便番号と合わない都道府県）を入れて「**登録する**」を押します。欄の下に「チェックアウト住所バリデーター」のエラーの文が出て、フォームが閉じなければ設定は完了です。保存のあと、ストアに反映されるまで少し時間がかかることがあります。

![振り分け画面の「新しいお届け先を追加」。都道府県の欄の下に「郵便番号100-0001は東京都の住所です。都道府県を「東京都」に修正してください。」と表示されている](https://mintcdn.com/bouquet-inc/rvTriPsVTyWOQlee/images/multigifts/address-validator-storefront-error.jpg?fit=max\&auto=format\&n=rvTriPsVTyWOQlee\&q=85\&s=5319ce94b3ec815278b5b187b980a8c1)

## お客様の画面での動き

* 「**登録する**」を押すと「**住所を確認しています…**」と表示され、確認が終わるまでボタンが押せなくなります（数秒かかることがあります）
* 誤りがあると、該当する欄の下にエラーの文が表示され、フォームは閉じません。お客様が直して「**登録する**」を押し直すと登録されます
* どの欄にも当たらないエラーの文は、「**登録する**」のボタンの上に表示されます
* エラーの文は、「チェックアウト住所バリデーター」で設定した文がそのまま表示されます。英語のストアでも日本語のままです

## 確かめられないときは、そのまま登録します

「チェックアウト住所バリデーター」に届かないときや、APIキーが使えなくなっているときは、お客様を止めずに、住所を確かめないで登録します。問題があったことは、MultiGiftsの「**連携アプリ**」に日時と一緒に表示されます。

| 「連携アプリ」の表示 | 起きていること | 対応 |
| - | - | - |
| APIキーかシークレットが使えなくなっています | 「チェックアウト住所バリデーター」でAPIキーを再発行した、または無効化した | 新しいAPIキーとシークレットを登録する |
| 届きませんでした | 障害や通信の時間切れで、応答がなかった | 時間をおいて、ストアで確かめる |
| 月間の上限に達したため、一部の確認を飛ばしました | 「チェックアウト住所バリデーター」のプランの月間の上限に達した | 上限を上げるには、「チェックアウト住所バリデーター」のプランを変える |
| 保存済みのシークレットを読めません | 保存したシークレットを読めなくなった | シークレットを入れ直して保存する |

## 送る情報と利用の回数

お届け先の確認では、お客様が入れた**姓・名・郵便番号・都道府県・市区町村・番地・建物名**を「チェックアウト住所バリデーター」に送ります。電話番号は送りません。確認の結果はMultiGiftsに保存せず、住所はShopifyのお客様アカウントに保存されます（[お届け先の住所はどこに保存されますか？](https://docs.bouquet-inc.com/apps/multigifts/faq/addresses.md)）。

確認は、お客様が「**登録する**」を押すたびと、「**連携アプリ**」で保存するとき（見本の住所で1回）に行います。「チェックアウト住所バリデーター」の利用の回数に数えられることがあります。

## APIキーを変える・連携を解除する

* 「チェックアウト住所バリデーター」でAPIキーを**再発行**すると、前のAPIキーは使えなくなります。新しいAPIキーとシークレットを「**連携アプリ**」に登録してください。登録するまでは、住所を確かめずに登録します
* 「**連携アプリ**」で片方の欄を空欄のまま保存すると、その欄は登録済みの値のままになります
* 「**連携を解除する**」を押すと、登録したAPIキーとシークレットが消え、住所を確かめなくなります。もう一度連携するときは、APIキーとシークレットを入れ直します
* MultiGiftsをアンインストールすると、登録したAPIキーとシークレットも消えます

## 関連ページ

* [お届け先の住所はどこに保存されますか？](https://docs.bouquet-inc.com/apps/multigifts/faq/addresses.md)
* [ご注文から子注文ができるまで](https://docs.bouquet-inc.com/apps/multigifts/orders/how-it-works.md)
* [MultiGiftsのよくある質問](https://docs.bouquet-inc.com/apps/multigifts/faq.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.