Konfiguracja modułu obsługi płatności Google Pay

Ten dokument referencyjny jest oparty na schemacie obiektu config dla obsługi płatności Google Pay w protokole Universal Commerce Protocol (UCP).

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

Właściwości

Właściwość Typ Czy jest wymagana Opis
api_version liczba całkowita Wymagane Główna wersja interfejsu Google Pay API. Obsługiwana jest tylko wersja 2.
api_version_minor liczba całkowita Wymagane Wersja pomocnicza Google Pay API. Obsługiwana jest tylko wartość 0.
environment ciąg znaków Wymagane Środowisko Google Pay, z którego chcesz korzystać.
  • TEST: dane do płatności przeznaczone tylko do testowania.
  • PRODUCTION: prawdziwe dane do autoryzacji płatności.
merchant_info obiekt Wymagane Dane identyfikacyjne sprzedawcy.
merchant_info.merchant_id ciąg znaków Wymagane Identyfikator sprzedawcy Google Pay z Konsoli usług Google Pay i Portfela Google. Jest to wymagane w środowisku PRODUCTION. Jest opcjonalny i ignorowany w środowisku TEST.
merchant_info.merchant_name ciąg znaków Opcjonalny Nazwa firmy sprzedawcy widoczna dla użytkowników.
merchant_info.merchant_origin ciąg znaków Opcjonalny W pełni kwalifikowana domena internetowa, w której następuje płatność (format: hostname).
merchant_info.auth_jwt ciąg znaków Opcjonalny Token JWT autoryzacji w przypadku niektórych kontekstów integracji.
allowed_payment_methods object[ ] Wymagane Formy płatności dozwolone w przypadku tej transakcji.
allowed_payment_methods[].type ciąg znaków Wymagane Typ obsługiwanej formy płatności. Obsługiwany jest tylko typ CARD.
allowed_payment_methods[].parameters obiekt Wymagane Parametry niezbędne do skonfigurowania formy płatności CARD.
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] Wymagane Pola obsługiwane podczas uwierzytelniania transakcji kartą.
  • PAN_ONLY: zwraca główny numer konta (PAN) i datę ważności karty zapisanej w Portfelu Google.
allowed_payment_methods[].parameters.allowed_card_networks string[ ] Wymagane Sieci kart obsługiwane przez sprzedawcę. Obsługiwane wartości: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards Wartość logiczna Opcjonalny Ustaw jako false, jeśli nie obsługujesz kart przedpłaconych. Wartość domyślna to true.
allowed_payment_methods[].parameters.allow_credit_cards Wartość logiczna Opcjonalny Ustaw jako false, jeśli nie obsługujesz kart kredytowych. Wartość domyślna to true.
allowed_payment_methods[].parameters.assurance_details_required Wartość logiczna Opcjonalny Ustaw jako true, by wysyłać żądanie szczegółów dotyczących gwarancji karty.
allowed_payment_methods[].parameters.billing_address_required Wartość logiczna Opcjonalny Ustaw jako true, jeśli do zrealizowania transakcji wymagany jest adres rozliczeniowy.
allowed_payment_methods[].parameters.billing_address_parameters obiekt Opcjonalny Parametry, które konfigurują zwracany adres rozliczeniowy.
allowed_payment_methods[].parameters.billing_address_parameters.format ciąg znaków Opcjonalny Format adresu rozliczeniowego niezbędny do zrealizowania transakcji.
  • MIN: imię i nazwisko, kod kraju, kod pocztowy (domyślnie).
  • FULL: imię i nazwisko, ulica i numer, miejscowość, region, kod kraju, kod pocztowy.
  • FULL-ISO3166: imię i nazwisko, ulica i numer, miejscowość, region, kod kraju, kod pocztowy i iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required Wartość logiczna Opcjonalny Ustaw jako true, jeśli do sfinalizowania transakcji wymagany jest numer telefonu.
allowed_payment_methods[].tokenization_specification obiekt Wymagane Konfiguracja określająca sposób zwracania danych uwierzytelniających płatność.
allowed_payment_methods[].tokenization_specification.type ciąg znaków Wymagane Typ tokenizacji.
  • PAYMENT_GATEWAY: używany, jeśli przetwarzasz płatności za pomocą [obsługiwanej bramy](/pay/api#participating-processors). Zwraca zaszyfrowany ładunek, który należy przekazać dostawcy usług płatniczych.
  • DIRECT: używane, jeśli samodzielnie odszyfrowujesz dane logowania (wymaga zgodności ze standardem PCI DSS Level 1).
allowed_payment_methods[].tokenization_specification.parameters obiekt Wymagane Parametry wybranego typu tokenizacji type.

W przypadku PAYMENT_GATEWAY wymagane parametry to: W przypadku DIRECT wymagane parametry to:
  • protocolVersion: wersja protokołu szyfrowania i podpisywania, która powinna znajdować się w danych logowania Google Pay. Obsługiwana jest tylko wartość ECv2. Więcej informacji znajdziesz w artykule Kryptografia danych płatności.
  • publicKey: klucz publiczny wykorzystujący krzywe eliptyczne zakodowany w standardzie Base64. Więcej informacji znajdziesz w sekcji Format publicznego klucza szyfrowania.