JSON レスポンス オブジェクト

このリファレンスでは、アプリケーションで使用する Google Pay API レスポンス オブジェクトのオプションについて説明します。レスポンス オブジェクトは、Google Pay API のクライアント メソッドによって返されるオブジェクトです。

PaymentData

これは、支払人が支払いを承認した後に Google から返されるレスポンス オブジェクトです。

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest。
プロパティ タイプ 常に存在 説明
apiVersion 数値 ○ API のメジャー バージョン。レスポンスの値は、
apiVersionMinor 数値 ○ API のマイナー バージョン。レスポンスの値は、
paymentMethodData PaymentMethodData ○ 選択したお支払い方法に関するデータ。
email 文字列 いいえ PaymentDataRequest。 別のリクエストでプロパティが true に設定されている場合、効果はありません。
shippingAddress 住所 いいえ

例

Google Pay API バージョン 2.0 のレスポンスの例を以下に示します。この例では、Google Pay のお支払いシートで CARD のお支払い方法が選択されています。example ゲートウェイのお支払い方法トークンが生成されました。

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

PaymentMethodData

このオブジェクトは、選択されたお支払い方法のデータを提供します。

プロパティ タイプ 常に存在 説明
type 文字列 ○ PaymentMethod Google Pay の支払いシートで選択された type。
description 文字列 ○

この取引の資金となるお支払い方法を説明する、ユーザー向けのメッセージ。
info オブジェクト ○ このプロパティの値は、返されるお支払い方法 type によって異なります。CARD については、CardInfo をご覧ください。
tokenizationData PaymentMethodTokenizationData いいえ 選択したお支払い方法の支払いトークン化データ。

例

このレスポンスの例は、Google Pay のお支払いシートで選択された CARD お支払い方法が、example ゲートウェイのお支払い方法トークンを生成する方法を示しています。

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

CardInfo

このオブジェクトは、選択した支払いカードに関する情報を提供します。

プロパティ タイプ 常に存在 説明
cardDetails 文字列 ○ カードの詳細。この値は通常、選択したお支払いアカウント番号の末尾 4 桁です。
assuranceDetails AssuranceDetailsSpecifications ○ このオブジェクトは、 CardParameters。
cardNetwork 文字列 ○

選択した支払いの支払いカード ネットワーク。 返される値は、 CardParameters.

このカード ネットワークの値は購入者に表示しないでください。購入者のカードの詳細が必要な場合に使用されます。たとえば、カスタマー サポートが、購入者が取引に使用したカードを識別するためにこの値を必要とする場合などです。ユーザーに表示される説明には、代わりに PaymentMethodData の description プロパティを使用します。
billingAddress 住所 いいえ CardParameters.
cardFundingSource 文字列 ○

選択したお支払い方法のカードの入金元。

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

例

この例は、Visa ネットワークのカードを示しています。

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

AssuranceDetailsSpecifications

このオブジェクトは、返された支払い認証情報で実行された検証に関する情報を提供します。これにより、適切なインストルメントのリスクチェックを適用できます。

名前 タイプ 説明
accountVerified ブール値 true の場合、返された支払い認証情報に対して Cardholder の所有検証が行われたことを示します。
cardHolderAuthenticated ブール値

true の場合、返された支払い認証情報で識別と検証（ID&V）が行われたことを示します。

false の場合、カード取引に使用するのと同じリスクベースの認証を実行できます。このリスクベースの認証には、該当する場合は 3D セキュア プロトコルによるステップアップが含まれますが、これに限定されません。

assuranceDetails フィールドを使用しない場合でも、レスポンス オブジェクトを受信して処理できます。このオブジェクトを受け取るには、Request オブジェクトの CardParameters。

PaymentMethodTokenizationData

このオブジェクトは、お支払い方法のトークン化データを提供します。

プロパティ タイプ 常に存在 説明
type 文字列 ○ 選択したお支払い方法に適用するトークン化のタイプ。 この値は、 PaymentMethodTokenizationSpecification。
token 文字列 いいえ

生成されたお支払い方法トークン。

例

これは、example ゲートウェイ用に準備されたトークン化されたレスポンスの例です。

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

PaymentAuthorizationResult

このオブジェクトは、支払い承認の結果に関する情報を提供します。

プロパティ タイプ 必要性 説明
transactionState 文字列 必須 取引のステータスは、次のいずれかの販売者の結果によって解決されます。
  • SUCCESS
  • ERROR
error PaymentDataError 省略可 支払いの再試行が必要な場合に、ユーザーの支払いシートに表示されるエラー。

例

次の例は、支払いの処理後に返される支払い結果を示しています。

{
  "transactionState": "ERROR",
  "error": {
    "reason": "PAYMENT_DATA_INVALID",
    "message": "Cannot pay with payment credentials",
    "intent": "PAYMENT_AUTHORIZATION"
  }
}

PaymentDataError

プロパティ タイプ 必要性 説明
reason 文字列 必須

事前定義されたエラー理由のリスト:

  • PAYMENT_DATA_INVALID
  • SHIPPING_ADDRESS_INVALID
  • SHIPPING_ADDRESS_UNSERVICEABLE
  • SHIPPING_OPTION_INVALID
  • OTHER_ERROR
message 文字列 必須 ダイアログに表示されるユーザー向けのエラー メッセージ。
intent 文字列 必須

エラーのインテント。

  • PAYMENT_AUTHORIZATION
  • SHIPPING_ADDRESS
  • SHIPPING_OPTION

例

この例では、決済シートに表示されるエラー インテントとメッセージを示します。

{
  "error": {
    "reason": "SHIPPING_OPTION_INVALID",
    "message": "This shipping option is invalid for the given address",
    "intent": "SHIPPING_OPTION"
  }
}

住所

このオブジェクトは、リクエストされた住所に関する情報を提供します。すべてのプロパティは文字列です。

住所は MIN、FULL、FULL-ISO3166 の形式で返すことができます。各形式に属するプロパティを次の表に示します。

プロパティ 住所の形式 説明
name MIN、FULL、FULL-ISO3166 受取人の氏名。
postalCode MIN、FULL、FULL-ISO3166 郵便番号。
countryCode MIN、FULL、FULL-ISO3166 ISO 3166-1 alpha-2 形式の国コード。
phoneNumber MIN、FULL、FULL-ISO3166 PaymentDataRequest。
address1 FULL、FULL-ISO3166 住所の 1 行目
address2 FULL、FULL-ISO3166 住所の 2 行目。
address3 FULL、FULL-ISO3166 住所の 3 行目。
locality FULL、FULL-ISO3166 市区町村、地域、郊外。
administrativeArea FULL、FULL-ISO3166 国の下位区分（州、都道府県など）。
sortingCode FULL、FULL-ISO3166 ソートコード。
iso3166AdministrativeArea FULL-ISO3166 administrativeArea に対応する ISO 3166-2 行政区域コード。

例

これは、複数行の番地データを含む米国の FULL-ISO3166 形式の住所の例です。

{
  "name": "John Doe",
  "address1": "c/o Google LLC",
  "address2": "1600 Amphitheatre Pkwy",
  "address3": "Building 40",
  "locality": "Mountain View",
  "administrativeArea": "CA",
  "countryCode": "US",
  "postalCode": "94043",
  "sortingCode": ""
  "iso3166AdministrativeArea": "US-CA"
}

IntermediatePaymentData

このオブジェクトは、支払いシートで配送先住所または配送オプションが変更されたときに、Google Pay API の onPaymentDataChanged() 入力によって返されます。

プロパティ タイプ 必要性 説明
callbackTrigger 文字列 省略可

支払いデータ コールバックが呼び出された理由を記述します。

  • INITIALIZE
  • SHIPPING_ADDRESS
  • SHIPPING_OPTION
  • PAYMENT_METHOD
shippingAddress IntermediateAddress 省略可 支払いシートで選択された住所。
shippingOptionData SelectionOptionData 省略可 支払いシートで選択された配送オプション。
paymentMethodData IntermediatePaymentMethodData 省略可 支払いシートで選択されたお支払い方法のデータ。

例

この例は、配送先住所の変更に対して Google Pay API から返される中間ペイロードを示しています。

{
  "callbackTrigger": "SHIPPING_ADDRESS",
  "shippingAddress": {
    "administrativeArea": "NY",
    "countryCode": "US",
    "locality": "New York",
    "postalCode": "10011"
  },
  "shippingOptionData": {
    "id": "shipping-001"
  }
}

この例は、お支払い方法が変更されたときに返される中間ペイロードを示しています。

{
  "callbackTrigger": "PAYMENT_METHOD",
  "paymentMethodData": {
    "type": "CARD",
    "info": {
      "cardNetwork": "VISA",
      "cardFundingSource": "CREDIT",
      "billingAddress": {
        "administrativeArea": "NY",
        "countryCode": "US",
        "locality": "New York",
        "postalCode": "10011"
      }
    }
  }
}

IntermediateAddress

中間アドレスには、ユーザーが支払いを承認する前に該当する税金と配送オプションを計算できるように、編集された配送先住所（番地レベルの住所行や受取人の名前は含まれません）が含まれています。

プロパティ タイプ 必要性 説明
administrativeArea 文字列 必須 国の下位区分（州、都道府県など）。
countryCode 文字列 必須 ISO 3166-1 alpha-2 形式の国コード。
locality 文字列 必須 市区町村、地域、郊外。
postalCode 文字列 必須 国に基づいて秘匿化された郵便番号。カナダと英国の場合、最初の 3 文字のみが含まれます。米国の場合、最初の 5 桁が含まれます。
iso3166AdministrativeArea 文字列 省略可 administrativeArea に対応する ISO 3166-2 行政区域コード。配送先住所の形式が FULL-ISO3166 の場合にのみ表示されます。

例

この例では、支払いシートで選択された住所が表示されます。

{
  "administrativeArea": "NY",
  "countryCode": "US",
  "locality": "New York",
  "postalCode": "10011"
  "iso3166AdministrativeArea": "US-NY"
}

SelectionOptionData

プロパティ タイプ 必要性 説明
id 文字列 必須 SelectionOption.id と一致

例

この例は、支払いシートで選択された配送オプションを示しています。

{
  "id": "shipping-001"
}

IntermediatePaymentMethodData

このオブジェクトには、デベロッパー コールバック用に選択されたお支払い方法に関する限定的な情報が含まれています。

プロパティ タイプ 必要性 説明
type 文字列 必須 お支払い方法の種類。このコールバックでは CARD のみがサポートされています。
info IntermediateCardInfo 省略可 選択したカードに関する情報。type が CARD の場合にのみ存在します。

IntermediateCardInfo

このオブジェクトには、選択したカードに関する限定的な情報が含まれており、デベロッパー コールバックで使用されます。

プロパティ タイプ 必要性 説明
billingAddress IntermediateAddress 省略可 カードに関連付けられた請求先住所。請求先住所が必須に設定されている場合にのみ入力されます。
cardNetwork 文字列 省略可

選択した支払いカードの支払いカード ネットワーク。返される値は、 CardParameters.

このカード ネットワークの値は購入者に表示しないでください。
cardFundingSource 文字列 省略可

選択した支払いカードのカード入金元。

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID