Configurarea gestionării plăților Google Pay

Această referință se bazează pe schema obiectului de configurare pentru gestionarea plăților Google Pay pentru 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": {
          ...
        }
      }
    }
  ]
}

Proprietăți

Proprietate Tip Necesitate Descriere
api_version întreg Necesar Versiunea principală a API-ului Google Pay. Doar 2 este acceptată.
api_version_minor întreg Necesar Versiunea minoră a API-ului Google Pay. Este acceptată doar versiunea 0 .
environment şir Necesar Mediul Google Pay de utilizat.
  • TEST : Acreditări de plată doar pentru testare.
  • PRODUCTION : Acreditări de plată reale, autorizabile.
merchant_info obiect Necesar Datele de identitate ale comerciantului.
merchant_info. merchant_id şir Necesar ID-ul dvs. de comerciant Google Pay din consola Google Pay și Wallet . Acesta este obligatoriu pentru mediul PRODUCTION . Este opțional și ignorat în mediul TEST .
merchant_info. merchant_name şir Opțional Numele comercial al comerciantului, vizibil pentru utilizator.
merchant_info. merchant_origin şir Opțional Domeniul web complet calificat unde are loc finalizarea comenzii (format: hostname ).
merchant_info. auth_jwt şir Opțional Autorizare JWT pentru anumite contexte de integrare.
allowed_payment_methods obiect[ ] Necesar Metodele de plată permise pentru această tranzacție.
allowed_payment_methods[]. type şir Necesar Tipul metodei de plată acceptate. Se acceptă doar CARD .
allowed_payment_methods[]. parameters obiect Necesar Parametri necesari pentru configurarea metodei de plată CARD .
allowed_payment_methods[].parameters. allowed_auth_methods șir[ ] Necesar Câmpuri acceptate pentru autentificarea unei tranzacții cu cardul.
  • PAN_ONLY : Returnează numărul contului principal (PAN) și data de expirare pentru un card înregistrat în Google Wallet.
allowed_payment_methods[].parameters. allowed_card_networks șir[ ] Necesar Rețelele de carduri acceptate de comerciant. Valori acceptate: AMEX , DISCOVER , ELECTRON , ELO , ELO_DEBIT , INTERAC , JCB , MAESTRO , MASTERCARD , VISA .
allowed_payment_methods[].parameters. allow_prepaid_cards boolean Opțional Setați la false dacă nu acceptați carduri preplătite. Implicit este true .
allowed_payment_methods[].parameters. allow_credit_cards boolean Opțional Setați la false dacă nu acceptați carduri de credit. Implicit este true .
allowed_payment_methods[].parameters. assurance_details_required boolean Opțional Setați la true pentru a solicita detalii despre asigurarea cardului.
allowed_payment_methods[].parameters. billing_address_required boolean Opțional Setați la true dacă aveți nevoie de o adresă de facturare pentru a finaliza tranzacția.
allowed_payment_methods[].parameters. billing_address_parameters obiect Opțional Parametrii care configurează adresa de facturare returnată.
allowed_payment_methods[].parameters.billing_address_parameters. format şir Opțional Formatul adresei de facturare este necesar pentru finalizarea tranzacției.
  • MIN : Nume, codul țării și codul poștal (implicit).
  • FULL : Nume, adresă, localitate, regiune, prefix și cod poștal.
  • FULL-ISO3166 : Nume, adresă, localitate, regiune, cod de țară, cod poștal și iso3166AdministrativeArea .
allowed_payment_methods[].parameters.billing_address_parameters. phone_number_required boolean Opțional Setați la true dacă aveți nevoie de un număr de telefon pentru a finaliza tranzacția.
allowed_payment_methods[]. tokenization_specification obiect Necesar Configurație care definește modul în care vă sunt returnate acreditările de plată.
allowed_payment_methods[].tokenization_specification. type şir Necesar Tipul de tokenizare.
  • PAYMENT_GATEWAY : Se utilizează dacă procesați plăți printr-un [gateway acceptat](/pay/api#participating-processors). Returnează o sarcină criptată care trebuie transmisă către PSP-ul dvs.
  • DIRECT : Se utilizează dacă decriptați singur acreditările (necesită conformitate cu PCI DSS Nivelul 1).
allowed_payment_methods[].tokenization_specification. parameters obiect Necesar Parametri specifici type de tokenizare selectat.

Pentru PAYMENT_GATEWAY , parametrii necesari sunt: Pentru DIRECT , parametrii necesari sunt:
  • protocolVersion : Versiunea protocolului de criptare și semnătură așteptat în acreditările Google Pay. Este acceptat doar ECv2 . Consultați secțiunea Criptografia datelor de plată pentru mai multe informații.
  • publicKey : cheie publică cu curbă eliptică codificată în Base64. Consultați secțiunea Formatul cheii publice de criptare pentru mai multe informații.