Obiekty odpowiedzi JSON

PaymentData

Jest to obiekt odpowiedzi zwracany przez Google po zatwierdzeniu płatności przez płatnika.

Przykład

Ten przykładowy kod odpowiedzi dla interfejsu Google Pay API w wersji 2.0 pokazuje formę płatności CARD wybraną w arkuszu płatności Google Pay. Wygenerowano token formy płatności dla bramki 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

Ten obiekt dostarcza dane dotyczące wybranej formy płatności.

Przykład

Ten przykładowy komunikat odpowiedzi pokazuje, jak forma płatności CARD wybrana w arkuszu płatności Google Pay generuje token formy płatności dla bramki example.

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

CardInfo

Ten obiekt dostarcza informacje o wybranej karcie płatniczej.

Przykład

Ten przykład pokazuje kartę w sieci Visa.

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

AssuranceDetailsSpecifications

Ten obiekt dostarcza informacji o tym, jaka weryfikacja została przeprowadzona na zwróconych danych uwierzytelniających płatność, aby można było zastosować odpowiednie kontrole ryzyka instrumentu.

Możesz otrzymać i przetworzyć obiekt odpowiedzi, nawet jeśli nie używasz pola assuranceDetails. Aby otrzymać ten obiekt, uwzględnij assuranceDetailsRequired: true w obiekcie żądania CardParameters.

PaymentMethodTokenizationData

Ten obiekt dostarcza dane tokenizacji dla formy płatności.

Przykład

To jest przykład odpowiedzi z tokenem przygotowanej dla bramy example.

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

PaymentAuthorizationResult

Ten obiekt dostarcza informacje o wyniku autoryzacji płatności.

Przykład

Poniższy przykład pokazuje wynik płatności zwrócony po przetworzeniu płatności:

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

PaymentDataError

Przykład

Ten przykład pokazuje intencję błędu i komunikat, który ma zostać wyświetlony w arkuszu płatności.

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

Adres

Ten obiekt dostarcza informacje o żądanym adresie pocztowym. Wszystkie właściwości są ciągami znaków.

Adresy mogą być zwracane w formatach MIN, FULL i FULL-ISO3166. Właściwości poszczególnych formatów znajdziesz w tabeli poniżej.

Przykład

Oto przykład adresu w formacie FULL-ISO3166 w Stanach Zjednoczonych z wieloma wierszami danych adresu.

{
  "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

Ten obiekt jest zwracany przez dane wejściowe onPaymentDataChanged() interfejsu Google Pay API, gdy adres dostawy lub opcje dostawy zostaną zmienione w arkuszu płatności.

Przykłady

Ten przykład pokazuje ładunek pośredni zwracany przez interfejs Google Pay API w przypadku zmian adresu dostawy.

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

Ten przykład pokazuje ładunek pośredni zwracany po zmianie formy płatności.

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

IntermediateAddress

Adres pośredni zawiera ukryty adres dostawy (bez ulicy i nazwy odbiorcy), aby umożliwić obliczenie odpowiedniego podatku i opcji dostawy, zanim użytkownik autoryzuje płatność.

Przykład

Ten przykład pokazuje adres wybrany w arkuszu płatności.

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

SelectionOptionData

Przykład

Ten przykład pokazuje opcję dostawy wybraną w arkuszu płatności.

{
  "id": "shipping-001"
}

IntermediatePaymentMethodData

Ten obiekt zawiera ograniczone informacje o wybranej formie płatności na potrzeby wywołań zwrotnych dewelopera.

IntermediateCardInfo

Ten obiekt zawiera ograniczone informacje o wybranej karcie, używane w wywołaniach zwrotnych dewelopera.