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

Ten dokument odnosi się do schematu obiektu config w przypadku modułu obsługi płatności Google Pay dla protokołu 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,
        "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łówny numer wersji Google Pay API. Obsługiwana jest tylko wartość 2.
api_version_minor liczba całkowita Wymagane Pomocniczy numer wersji Google Pay API. Obsługiwana jest tylko wartość 0.
environment ciąg znaków Wymagane Środowisko Google Pay, którego chcesz używać.
  • TEST: dane uwierzytelniające płatności tylko do testowania.
  • PRODUCTION: prawdziwe dane uwierzytelniające płatności, które można autoryzować.
merchant_info obiekt Wymagane Dane identyfikacyjne sprzedawcy.
merchant_info.merchant_id ciąg znaków Wymagane Identyfikator sprzedawcy w Google Pay z Konsoli usług Google Pay i Portfela Google. Jest to wymagane w środowisku PRODUCTION. W środowisku TEST jest to opcjonalne i ignorowane.
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 Pełna i jednoznaczna nazwa domeny, w której odbywa się 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 obiekt[ ] 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ługiwane wartości: CARD, EWALLET.
allowed_payment_methods[].parameters obiekt Opcjonalny Parametry wymagane do skonfigurowania formy płatności CARD. Ta właściwość jest wymagana, jeśli type ma wartość CARD.
allowed_payment_methods[].parameters.allowed_auth_methods ciąg znaków[ ] Wymagane Pola obsługiwane podczas uwierzytelniania transakcji kartą.
  • PAN_ONLY: zwraca podstawowy numer konta (PAN) i datę ważności karty zapisanej w Portfelu Google.
allowed_payment_methods[].parameters.allowed_card_networks ciąg znaków[ ] 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.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 oraz kod pocztowy (domyślnie).
  • FULL: imię i nazwisko, ulica i numer, miejscowość, region, kod kraju oraz kod pocztowy.
  • FULL-ISO3166: imię i nazwisko, ulica i numer, miejscowość, region, kod kraju, kod pocztowy oraz iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required Wartość logiczna Opcjonalny Ustaw jako true, jeśli do zrealizowania transakcji wymagany jest numer telefonu.
allowed_payment_methods[].tokenization_specification obiekt Opcjonalny Konfiguracja określająca, w jaki sposób dane uwierzytelniające płatności są zwracane. Ta właściwość jest wymagana, jeśli type ma wartość CARD.
allowed_payment_methods[].tokenization_specification.type ciąg znaków Wymagane Typ tokenizacji.
  • PAYMENT_GATEWAY: używany, jeśli płatności są przetwarzane przez [obsługiwaną bramę](/pay/api#participating-processors). Zwraca zaszyfrowany ładunek, który ma zostać przekazany do dostawcy usług płatniczych.
  • DIRECT: używany, jeśli samodzielnie odszyfrowujesz dane uwierzytelniające (wymaga zgodności ze standardem PCI DSS na poziomie 1).
allowed_payment_methods[].tokenization_specification.parameters obiekt Wymagane Parametry specyficzne dla wybranego type tokenizacji.

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 uwierzytelniających 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.
allowed_payment_methods[].processing_specification obiekt Opcjonalny Określ informacje wymagane do przetworzenia płatności. Ta właściwość jest wymagana, jeśli type ma wartość EWALLET.
allowed_payment_methods[].processing_specification.type ciąg znaków Wymagane Typ dostawcy e-portfela. Obsługiwane wartości: SHOPEE_PAY, TOUCH_N_GO.
allowed_payment_methods[].processing_specification.parameters obiekt Wymagane Parametry specyficzne dla wybranego dostawcy e-portfela.

Wymagane parametry to:
  • ewallet_merchant_name: nazwa sprzedawcy widoczna dla użytkowników.
  • ewallet_merchant_account: identyfikator sprzedawcy wydany przez e-portfel lub agregatora.
  • psp_transaction_reference: unikalny numer referencyjny wygenerowany przez dostawcę usług płatniczych na potrzeby idempotentności.