Oggetti di risposta

IsReadyToPayResponse

Questo oggetto fornisce informazioni sulla capacità di un visitatore del sito web di fornire dati di pagamento al sito che li richiede.

Esempio

L'esempio seguente mostra quando il visitatore corrente è in grado di fornire i dati di pagamento al sito che li richiede.

{
  "result": true
}

PaymentData

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

Esempio

Questa risposta di esempio per l'API Google Pay versione 2.0 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"
    }
  }
}

IntermediatePaymentData

Questo oggetto viene restituito dall'input onPaymentDataChanged() dell'API Google Pay quando l'indirizzo di spedizione o le opzioni di spedizione vengono modificati nel foglio di pagamento.

Esempi

Questo esempio mostra il payload intermedio restituito dall'API Google Pay per le modifiche all'indirizzo di spedizione.

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

Questo esempio mostra il payload intermedio restituito quando il metodo di pagamento cambia.

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

PaymentMethodData

Questo oggetto fornisce i dati per un 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.

Esempio

Questo esempio mostra una carta del 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 da poter applicare i controlli del rischio dello strumento appropriati.

Puoi ricevere ed elaborare l'oggetto di 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.

Esempio

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

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

PaymentAuthorizationResult

Questo oggetto fornisce informazioni sul risultato dell'autorizzazione di pagamento.

Esempio

L'esempio seguente mostra il risultato del pagamento restituito dopo l'elaborazione di un pagamento:

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

PaymentDataError

Esempio

Questo esempio mostra l'intent e il messaggio di errore da visualizzare nel foglio di pagamento.

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

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.

Esempio

Questo è un esempio di indirizzo in formato FULL-ISO3166 negli Stati Uniti con più righe di dati relativi alla via.

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

IntermediateAddress

L'indirizzo intermedio contiene un indirizzo di spedizione oscurato (senza righe di indirizzo a livello di via o nomi dei destinatari) per consentire il calcolo delle opzioni di spedizione e delle imposte applicabili prima che l'utente autorizzi il pagamento.

Esempio

Questo esempio mostra l'indirizzo selezionato nel foglio di pagamento.

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

SelectionOptionData

Esempio

Questo esempio mostra l'opzione di spedizione selezionata nel foglio di pagamento.

{
  "id": "shipping-001"
}

OfferData

Questo oggetto fornisce informazioni su un codice offerta inserito nel foglio di pagamento.

Esempio

L'esempio seguente mostra un oggetto OfferData con un array redemptionCodes.

"offerData": {
    "redemptionCodes": ["PROMOTIONALCODE"]
}

IntermediatePaymentMethodData

Questo oggetto contiene informazioni limitate sul metodo di pagamento selezionato per i callback degli sviluppatori.

IntermediateCardInfo

Questo oggetto contiene informazioni limitate sulla carta selezionata, utilizzate nei callback degli sviluppatori.