Google Pay のお支払い方法

このリファレンスは、カード支払い方法 スキーマ に基づいています。これは、Google Pay 支払い ハンドラがチェックアウト完了時に payment.instruments 配列内で返すお支払い方法オブジェクトのものです。

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

プロパティ

プロパティ タイプ 常に存在しますか？ 説明
id 文字列 ○ プラットフォームによって割り当てられた、このお支払い方法インスタンスの一意の識別子。
handler_id 文字列 ○ このお支払い方法を生成したハンドラ インスタンスの一意の識別子。支払いハンドラ構成の id フィールドに対応します。
type 文字列 ○ お支払い方法のタイプ（card など）。
selected ブール値 いいえ このお支払い方法がユーザーによって選択されたかどうかを示します。
display オブジェクト ○ お支払い方法の表示情報。
display.brand 文字列 ○ カードのブランド/ネットワーク（「VISA」など）。
display.last_digits 文字列 ○ カード番号の末尾 4 桁。
display.description 文字列 いいえ ユーザー向けのカードの説明。
display.card_art 文字列 いいえ カードを表す画像の URI。
billing_address オブジェクト いいえ カードに関連付けられた請求先住所。 構成で billing_address_required が true に設定されている場合にのみ返されます。
billing_address.first_name 文字列 いいえ 住所に関連付けられた連絡先の名前（名）。
billing_address.last_name 文字列 いいえ 住所に関連付けられた連絡先の名前（姓）。
billing_address.street_address 文字列 いいえ 番地です。
billing_address.extended_address 文字列 いいえ 住所の拡張（アパートや部屋番号など）。
billing_address.address_locality 文字列 いいえ 地域（都市など）。
billing_address.address_region 文字列 いいえ 地域（州や都道府県など）。
billing_address.postal_code 文字列 いいえ 郵便番号。
billing_address.address_country 文字列 いいえ 国コード（ISO 3166-1 alpha-2 形式の 2 文字）。
billing_address.phone_number 文字列 いいえ 電話番号。 構成で phone_number_required が true に設定されている場合にのみ返されます。
credential オブジェクト いいえ Google Pay から返される安全なトークン化データ。
credential.type 文字列 ○ トークン化のタイプ。構成されたタイプと一致します。
credential.token 文字列 ○ JSON シリアル化された文字列としての暗号化された支払い認証情報トークン。

PAYMENT_GATEWAY の場合、これにはゲートウェイに渡す暗号化されたペイロードが含まれます。 DIRECT の場合、これには暗号化されたカード情報が含まれます（秘密鍵を使用して復号する必要があります）。形式と復号プロセスの詳細については、支払いデータの暗号方式ガイドをご覧ください。