自動割引を設定する

価格トークンを実装するには、以下の説明に従ってください

トークンの構造

JWT トークンには、ヘッダーとペイロードの 2 つの JSON オブジェクトが含まれます。

ヘッダー

---

{

"alg": "ES256",

"typ": "JWT"

}

---

Google が生成するトークン ヘッダーには次の 2 つのフィールドがあります。

• alg - 使用されるアルゴリズム、値は常に "ES256"
• typ - メディアタイプ、値は常に "JWT"

トークン ヘッダーに他のフィールドがある場合や、フィールドの値が上記とは異なる場合は、トークンを拒否する必要があります。

ペイロード

---

{

"exp": 1571673600,

"o": "tddy123uk",

"m": "140301646",

"p": 21.99,

"c": "JPY"

}

---

ペイロードには以下のフィールドがあります。

• exp - 有効期限（Unix 時間）。トークンの有効期限が切れている場合は、拒否する必要があります。
• o - オファー ID。ランディング ページが商品と一致しているかどうかを確認するために使用できます。不一致があった場合は、トークンを拒否する必要があります。
• m - 販売者 ID。販売者 ID が一致しない場合、トークンを拒否する必要があります。
• p - 割引価格
• c - 通貨、大文字

トークンの使用

トークンの使用に関する正確な詳細は、使用するライブラリによって異なりますが、大まかな手順は、デコードと署名の検証、フィールドの検証、価格の使用の 3 つです。

デコードと署名の検証 Base64URL でエンコードされたトークンが pv2 URL リクエスト パラメータで渡されます。

ほとんどのライブラリではデコードと署名の検証を組み合わせて 1 つの関数にしています。入力は「token」、「ES256」（アルゴリズム）、「public key」で、出力は「token_body」です。

検証用の公開鍵:

次のキーは、自動割引のすべてのユーザーが期限なしで使用することを想定しています。

フィールドの検証

選択したライブラリが前のステップで鍵とアルゴリズムを受け取り、ヘッダー オプションにかかわらずそれらを強制的に使用する場合、ヘッダーの追加確認は必要ありません。それ以外の場合は、上記のガイドラインに従ってヘッダー フィールドを確認する必要があります。詳しくは、JSON Web Token Best Current Practices（JSON ウェブトークンの現在のベスト プラクティス）をご覧ください。

使用しているライブラリにかかわらず、販売者側のデータに照らして o、m、p のフィールドを検証する必要があります。一致しない場合は、ユーザーが商品および販売者間でトークンをコピーできないように、トークンを拒否する必要があります。販売者は exp フィールドを確認してトークンが期限切れの場合は拒否できます。ただし、これは必須ではありません。

価格の使用 すべてのフィールドが有効でトークンが期限切れではない場合、販売者は p フィールドで指定された価格を使用する必要があります。

このページに記載されている要件を既存のクーポン機能が満たしている場合、それを使用して価格を割り引きできます。特に、ランディング ページの価格は、トークンの価格と一致している必要があり、購入手続きページで割引を追加するだけでは不十分です。

テスト 統合が完了すると、以下の 3 つのステップでテストが行われます。

• 機能テスト（販売者が実施）
• 鍵の検証（Google が提供するトークンを使用して販売者が実施）
• 完全なエンドツーエンドのテスト（Google が実施）

機能テスト 開発中および開発後にテストを行う最も簡単な方法は、一時的な鍵ペアを生成することです。これにより、トークンを完全に管理できます。以下のコマンドを使用すると、有効な鍵ペアを生成できます。

トークンは、ES256 をアルゴリズムとして使用して jwt.io などのツールで生成できます。

鍵の検証 本番環境用の鍵が正しく設定されていることを検証するため、オンボーディング中に Merchant Center で署名付きトークンを使用できます（サンプル URL）。