Oggetti di risposta JSON

Questo riferimento descrive le opzioni dell'oggetto di risposta dell'API Google Pay da utilizzare con la tua applicazione. Gli oggetti di risposta sono oggetti restituiti dai metodi client dell'API Google Pay.

PaymentData

Si tratta di un oggetto di risposta restituito da Google dopo che un pagatore approva il pagamento.

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.
Proprietà Tipo Esiste sempre Descrizione
apiVersion numero Sì Versione principale dell'API. Il valore nella risposta corrisponde al valore fornito in
apiVersionMinor numero Sì Versione secondaria dell'API. Il valore nella risposta corrisponde al valore fornito in
paymentMethodData PaymentMethodData Sì Dati sul metodo di pagamento selezionato.
email stringa No Indirizzo email, se emailRequired è impostato su true in PaymentDataRequest. Se un'altra richiesta ha la proprietà impostata su true, non ha alcun effetto.
shippingAddress Indirizzo No Indirizzo di spedizione, se shippingAddressRequired è impostato su true in

Esempio

Questa risposta di esempio per la versione 2.0 dell'API Google Pay mostra un metodo di pagamento CARD selezionato nel foglio di pagamento di Google Pay. È stato generato un token del metodo di pagamento per il gateway 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

Questo oggetto fornisce i dati per un metodo di pagamento selezionato.

Proprietà Tipo Esiste sempre Descrizione
type stringa Sì PaymentMethod type selezionato nel modulo di pagamento di Google Pay.
description stringa Sì

Messaggio rivolto all'utente per descrivere il metodo di pagamento che finanzia questa transazione.
info oggetto Sì Il valore di questa proprietà dipende dal metodo di pagamento type restituito. Per CARD, vedi CardInfo.
tokenizationData PaymentMethodTokenizationData No Dati di tokenizzazione del pagamento per il metodo di pagamento selezionato.

Esempio

Questa risposta di esempio mostra come un metodo di pagamento CARD selezionato nel foglio di pagamento di Google Pay genera un token del metodo di pagamento per il gateway example.

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

CardInfo

Questo oggetto fornisce informazioni sulla carta di pagamento selezionata.

Proprietà Tipo Esiste sempre Descrizione
cardDetails stringa Sì I dettagli della carta. Questo valore corrisponde in genere alle ultime quattro cifre del numero di conto pagamenti selezionato.
assuranceDetails AssuranceDetailsSpecifications Sì Questo oggetto fornisce informazioni sulla convalida eseguita sui dati di pagamento restituiti se assuranceDetailsRequired è impostato su true in CardParameters.
cardNetwork stringa Sì

Il circuito della carta di pagamento del pagamento selezionato. I valori restituiti corrispondono al formato di allowedCardNetworks in CardParameters.

Questo valore della rete di carte non deve essere mostrato all'acquirente. Viene utilizzato quando sono necessari i dettagli della carta di un acquirente. Ad esempio, se l'assistenza clienti ha bisogno di questo valore per identificare la carta utilizzata da un acquirente per la transazione. Per una descrizione visibile all'utente, utilizza invece la proprietà description di PaymentMethodData.
billingAddress Indirizzo No L'indirizzo di fatturazione associato al metodo di pagamento fornito, se billingAddressRequired è impostato su true in CardParameters.
cardFundingSource stringa Sì

Fonte di finanziamento della carta per il metodo di pagamento selezionato.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Esempio

Questo esempio mostra una carta sul circuito Visa.

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

AssuranceDetailsSpecifications

Questo oggetto fornisce informazioni sulla convalida eseguita sulle credenziali di pagamento restituite in modo che possano essere applicati controlli del rischio dello strumento appropriati.

Nome Tipo Descrizione
accountVerified booleano Se true, indica che è stata eseguita la convalida del possesso di Cardholder sulle credenziali di pagamento restituite.
cardHolderAuthenticated booleano

Se true, indica che l'identificazione e le verifiche (ID&V) sono state eseguite sulla credenziale di pagamento restituita.

Se false, è possibile eseguire la stessa autenticazione basata sul rischio che per le transazioni con carta. Questa autenticazione basata sul rischio può includere, a titolo esemplificativo, la verifica con il protocollo 3D Secure, se applicabile.

Puoi ricevere ed elaborare l'oggetto risposta anche se non utilizzi il campo assuranceDetails. Per ricevere questo oggetto, includi assuranceDetailsRequired: true nell'oggetto Request CardParameters.

PaymentMethodTokenizationData

Questo oggetto fornisce i dati di tokenizzazione per il metodo di pagamento.

Proprietà Tipo Esiste sempre Descrizione
type stringa Sì Il tipo di tokenizzazione da applicare al metodo di pagamento selezionato. Questo valore corrisponde a type impostato in PaymentMethodTokenizationSpecification.
token stringa No

Il token del metodo di pagamento generato.

Esempio

Questo è un esempio di risposta tokenizzata preparata per il gateway example.

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

Indirizzo

Questo oggetto fornisce informazioni su un indirizzo postale richiesto. Tutte le proprietà sono stringhe.

Gli indirizzi possono essere restituiti nei formati MIN,FULL e FULL-ISO3166. Le proprietà appartenenti a ciascun formato sono riportate nella tabella seguente.

Proprietà Formato dell'indirizzo Descrizione
name MIN, FULL, FULL-ISO3166 Il nome completo del destinatario.
postalCode MIN, FULL, FULL-ISO3166 Il codice postale o CAP.
countryCode MIN, FULL, FULL-ISO3166 Codice paese ISO 3166-1 alpha-2.
phoneNumber MIN, FULL, FULL-ISO3166 Un numero di telefono, se phoneNumberRequired è impostato su true in PaymentDataRequest.
address1 FULL, FULL-ISO3166 La prima riga dell'indirizzo.
address2 FULL, FULL-ISO3166 La seconda riga dell'indirizzo.
address3 FULL, FULL-ISO3166 La terza riga dell'indirizzo.
locality FULL, FULL-ISO3166 Città, paese, quartiere o periferia.
administrativeArea FULL, FULL-ISO3166 Una suddivisione di un paese, ad esempio uno stato o una provincia.
sortingCode FULL, FULL-ISO3166 Il codice di smistamento.
iso3166AdministrativeArea FULL-ISO3166 Codice area amministrativa ISO 3166-2 corrispondente ad administrativeArea.

Esempio

Questo è un esempio di indirizzo in formato FULL-ISO3166 negli Stati Uniti con più righe di dati dell'indirizzo stradale.

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