Questa pagina di riferimento descrive le opzioni dell'oggetto richiesta dell'API Google Pay da utilizzare con la tua applicazione.
IsReadyToPayRequest
Questo oggetto specifica quali metodi di pagamento sono supportati.
| Proprietà | Tipo | Necessità | Descrizione |
|---|---|---|---|
apiVersion |
numero | Obbligatorio | Versione principale dell'API. Il valore è |
apiVersionMinor |
numero | Obbligatorio | Versione secondaria dell'API. Il valore è |
allowedPaymentMethods |
PaymentMethod[ ] | Obbligatorio | Specifica il supporto per uno o più metodi di pagamento supportati dall'API Google Pay. Un |
existingPaymentMethodRequired |
booleano | Facoltativo |
Se impostato su |
Esempio
Questo esempio mostra come supportare le carte di pagamento e i token dei dispositivi Android di tutte le reti di carte supportate.
{ "apiVersion": 2, "apiVersionMinor": 0, "allowedPaymentMethods": [ { "type": "CARD", "parameters": { "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"], "allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"] } } ] }
PaymentDataRequest
Utilizza questo oggetto per configurare il supporto dell'API Google Pay per il tuo e la tua app.
| Proprietà | Tipo | Necessità | Descrizione |
|---|---|---|---|
apiVersion |
numero | Obbligatorio | Versione principale dell'API. Il valore è 2 per questa
specifica. |
apiVersionMinor |
numero | Obbligatorio | Versione secondaria dell'API. Il valore è 0 per questa
specifica. |
merchantInfo |
MerchantInfo | Facoltativo | Informazioni sul commerciante che richiede i dati di pagamento. |
allowedPaymentMethods |
PaymentMethod[ ] | Obbligatorio | Specifica il supporto per uno o più metodi di pagamento supportati dall'API Google Pay. |
transactionInfo |
TransactionInfo | Condizionale | Dettagli sulla facilitazione della transazione in base all'accettazione o meno della transazione da parte dell'utente. Include il prezzo totale e lo stato del prezzo. Deve essere presente esattamente uno dei seguenti valori: |
recurringTransactionInfo |
RecurringTransactionInfo | Condizionale | Dettagli sull'iscrizione per una transazione ricorrente. |
deferredTransactionInfo |
DeferredTransactionInfo | Condizionale | Dettagli sulla registrazione per una transazione differita. |
automaticReloadTransactionInfo |
AutomaticReloadTransactionInfo | Condizionale | Dettagli sulla registrazione per la ricarica automatica di un account con saldo memorizzato. |
emailRequired |
booleano | Facoltativo | Imposta su true per richiedere un indirizzo email. |
shippingAddressRequired |
booleano | Facoltativo | Imposta true per richiedere un indirizzo di spedizione completo. |
shippingAddressParameters |
ShippingAddressParameters | Facoltativo | Se shippingAddressParameters è impostato su true, specifica le limitazioni
dell'indirizzo di spedizione. |
Esempio
L'esempio seguente mostra come supportare le carte di pagamento e i token dei dispositivi Android di tutte le reti di carte supportate. Le carte di pagamento vengono tokenizzate per un gateway di esempio. La richiesta è per un metodo di pagamento a cui addebitare un importo finale di 12,34 dollari statunitensi.
{ "apiVersion": 2, "apiVersionMinor": 0, "merchantInfo": { "merchantName": "Example Merchant" }, "allowedPaymentMethods": [ { "type": "CARD", "parameters": { "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"], "allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"] }, "tokenizationSpecification": { "type": "PAYMENT_GATEWAY", "parameters": { "gateway": "example", "gatewayMerchantId": "exampleGatewayMerchantId" } } } ], "transactionInfo": { "totalPriceStatus": "FINAL", "totalPrice": "12.34", "currencyCode": "USD" } }
PaymentDataCallbacks
Se la tua integrazione utilizza gli aggiornamenti dinamici dei prezzi, assicurati di implementare i callback
onPaymentDataChanged
e onPaymentAuthorized
nella classe Service e aggiungi un riferimento a questa classe nel file AndroidManifest.xml.
| Proprietà | Tipo | Necessità | Descrizione |
|---|---|---|---|
onPaymentDataChanged |
Metodo | Facoltativo | Richiamato quando l'utente aggiorna l'indirizzo di spedizione o l'opzione di spedizione nel foglio di pagamento. |
onPaymentAuthorized |
Metodo | Obbligatorio | Richiamato quando l'utente autorizza il pagamento nel foglio di pagamento. |
Esempio
La seguente configurazione di esempio definisce la classe necessaria per configurare gli aggiornamenti dinamici:
<service android:name="com.google.android.gms.test.wallet.PaymentDataCallbacksService" android:permission="com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE" android:exported="true"> <intent-filter> <action android:name="com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS"/> </intent-filter> </service>
Sostituisci il valore android:name nella configurazione con il nome del pacchetto della classe del servizio di callback.
MerchantInfo
Questo oggetto fornisce informazioni sul commerciante che richiede i dati di pagamento.
| Proprietà | Tipo | Necessità | Descrizione |
|---|---|---|---|
merchantName |
stringa | Facoltativo | Nome del commerciante codificato come UTF-8. Il nome del commerciante viene visualizzato nel foglio di pagamento. Nell'ambiente
TEST o se un commerciante non viene riconosciuto, nel foglio di pagamento viene visualizzato il messaggio
"Paga commerciante non verificato". |
Esempio
L'esempio seguente mostra un oggetto merchantInfo con merchantName.
"merchantInfo": { "merchantName": "Example Merchant" }
PaymentMethod
Questo oggetto specifica uno o più metodi di pagamento supportati dall'API Google Pay e accettati da your app.
| Proprietà | Tipo | Necessità | Descrizione |
|---|---|---|---|
type |
stringa | Obbligatorio | Un identificatore breve del metodo di pagamento supportato.
Non sono supportati più metodi di pagamento di tipo |
parameters |
oggetto | Obbligatorio | Parametri necessari per configurare il tipo di metodo di pagamento fornito. Per ulteriori informazioni sui valori previsti per il metodo di pagamento |
tokenizationSpecification |
PaymentMethodTokenizationSpecification | Facoltativo | Configura un account o un fornitore di decrittografia per ricevere i dati di pagamento. Questa proprietà è obbligatoria per il metodo di pagamento Questa proprietà non ha effetto se è inclusa in un |
L'esempio seguente mostra come supportare le carte di pagamento e i token dei dispositivi Android di tutte le reti di carte supportate. Questo esempio mostra la tokenizzazione tramite un gateway di esempio.
{
"type": "CARD",
"parameters": {
"allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
"allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"]
},
"tokenizationSpecification": {
"type": "PAYMENT_GATEWAY",
"parameters": {
"gateway": "example",
"gatewayMerchantId": "exampleGatewayMerchantId"
}
}
}
TokenizationSpecification
Questo oggetto ti consente di configurare un account per ricevere dati di pagamento addebitabili.
| Proprietà | Tipo | Necessità | Descrizione |
|---|---|---|---|
type |
stringa | Obbligatorio | Un tipo di tokenizzazione del metodo di pagamento è supportato per il
|
parameters |
oggetto | Obbligatorio | Parametri specifici per il tipo di tokenizzazione del metodo di pagamento selezionato. |
Gateway
Per recuperare i dati di pagamento e i dati del cliente da
un gateway di pagamento supportato dall'API Google Pay,
imposta type su PAYMENT_GATEWAY. Definisci le proprietà parameters
come descritto dal gateway. Le proprietà tipiche includono l'identificatore del gateway,
emesso da Google, e l'ID account gateway, fornito dal gateway.
L'esempio seguente mostra come recuperare informazioni da un gateway di pagamento:
"tokenizationSpecification": { "type": "PAYMENT_GATEWAY", "parameters": { "gateway": "example", "gatewayMerchantId": "exampleGatewayMerchantId" } }
Utilizza la tabella seguente per trovare i valori specifici di "gateway": e
"gatewayMerchantId": per il gateway supportato.
| Gateway | Parametri e documenti |
|---|---|
| 9Pay |
"gateway": "ninepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| 91APP PAYMENTS |
"gateway": "payments91app" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| A-IT |
"gateway": "aitecomm" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| ABA PayWay |
"gateway": "ababank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| accept.blue |
"gateway": "acceptblue" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| ACI |
"gateway": "aciworldwide" "gatewayMerchantId": "YOUR_ENTITY_ID" |
| ACpay |
"gateway": "acpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Acquired.com |
"gateway": "acquired" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Adyen |
"gateway": "adyen" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" |
| African Payment Solution (PTY) Ltd t/a LekkaPay |
"gateway": "lekkapay" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" |
| AI Fintech |
"gateway": "aifintech" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" |
| Airba Pay |
"gateway": "airbapay"" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" |
| Airvend |
"gateway": "airvend" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Airwallex |
"gateway": "airwallex" "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME" |
| Akua |
"gateway": "akua" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Akurateco |
"gateway": "akuratecolab" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Alfa-Bank |
"gateway": "alfabank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Algoritma |
"gateway": "algoritma" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Allinpay |
"gateway": "allinpayintl" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| AllPayments |
"gateway": "allpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| alticepay |
"gateway": "alticepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| AMO FINTECH LLC |
"gateway": "amofintech" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Amwal Pay |
"gateway": "amwalalraqamia" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" Nessuna documentazione per gli sviluppatori disponibile |
| Anedot |
"gateway": "anedot" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| ApcoPay |
"gateway": "apcopay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| APPEX |
"gateway": "epos" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Armenian Card OJSC |
"gateway": "epgarca" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| AsiaBill |
"gateway": "asiabill" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" Nessuna documentazione per gli sviluppatori disponibile |
| Assist |
"gateway": "assist" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Assist Belarus |
"gateway": "belassist" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Assist Kazakhstan |
"gateway": "assistkz" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Aurus |
"gateway": "auruspay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Authorize.net |
"gateway": "authorizenet" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Axerve |
"gateway": "gestpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| AXS |
"gateway": "axsasia" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" Nessuna documentazione per gli sviluppatori disponibile |
| azericardgpay |
"gateway": "azericardgpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| B2B Soft Pay |
"gateway": "b2bsoftpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bancstac |
"gateway": "bancstac" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bank 131 |
"gateway": "bank131" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bank Muscat |
"gateway": "bankmuscat" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BANK RBK |
"gateway": "bankrbkkzpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bank Vostok |
"gateway": "bankvostok" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Barclaycard |
"gateway": "barclayssmartpayadvance" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Barion |
"gateway": "barion" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Basis Theory |
"gateway": "basistheory" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BCC.KZ |
"gateway": "bccpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| bePaid |
"gateway": "ecomcharge" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bereke Bank |
"gateway": "berekepay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Better Payment Germany GmbH |
"gateway": "betterpayment" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Billing Systems |
"gateway": "billingsystems" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bindo Labs Limited |
"gateway": "bindo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| bisys.kz |
"gateway": "bisysgpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bizon.one |
"gateway": "bizonone" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bizzon |
"gateway": "bizzon" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Blackstone Merchant Services |
"gateway": "blackstone" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Blocks |
"gateway": "blocks" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bluefin |
"gateway": "bluefin" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bluefin Europe |
"gateway": "bluefineurope" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Blue Media |
"gateway": "bluemedia" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BlueSnap |
"gateway": "bluesnap" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Blusky Technology Services |
"gateway": "bluskysvcpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BORICA |
"gateway": "borica" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BPC |
"gateway": "bpcpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BR-DGE |
"gateway": "comcarde" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Braintree |
"gateway": "braintree" "braintree:apiVersion": "v1" "braintree:sdkVersion": "braintree.client.VERSION" "braintree:merchantId": "YOUR_BRAINTREE_MERCHANT_ID" "braintree:clientKey": "YOUR_BRAINTREE_TOKENIZATION_KEY" |
| Braspag |
"gateway": "cielo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BridgerPay |
"gateway": "bridgerpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Bonum |
"gateway": "bonumpsp" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| BT Pay |
"gateway": "btpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Buckaroo |
"gateway": "buckaroo" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Buya |
"gateway": "buya" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Callpay |
"gateway": "callpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CARDAQ |
"gateway": "cardaq" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CardCom |
"gateway": "cardcom" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CardConnect |
"gateway": "cardconnect" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Cardknox |
"gateway": "cardknox" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| cardlink |
"gateway": "cardlink" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Cardstream |
"gateway": "crst" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Cashflows |
"gateway": "cashflowsgateway" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Cathay United Bank |
"gateway": "cathaybk" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CCAvenue UAE |
"gateway": "ccavenueuae" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CCV |
"gateway": "ccv" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Cecabank |
"gateway": "cecabank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Celerispay |
"gateway": "celerispay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CentralPay |
"gateway": "centralpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Centrobill LTD |
"gateway": "centrobill" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Chargehive |
"gateway": "chargehive" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CharityEngine |
"gateway": "charityengine" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Chase Merchant Services |
"gateway": "chase" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Checkout.com |
"gateway": "checkoutltd" "gatewayMerchantId": "YOUR_PUBLIC_KEY" |
| CIBPAY MMC |
"gateway": "cibpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| City Bank PLC |
"gateway": "citybank" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CityPay |
"gateway": "citypay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Cloud9 Payment Gateway (C9PG) |
"gateway": "c9pg" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CloudPayments |
"gateway": "cloudpayments" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CloudWalk |
"gateway": "cloudwalk" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Coinflow |
"gateway": "coinflow" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Comax (Native Data LTD) |
"gateway": "comaxpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Computop |
"gateway": "computop" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| ConcordPay |
"gateway": "concordpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Conekta |
"gateway": "conektagpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Connectum |
"gateway": "connectum" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| ConnexPay |
"gateway": "connexpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| CoralPay |
"gateway": "coralpay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Corefy |
"gateway": "paycoreio" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Coriunder Limited |
"gateway": "coriunder" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" Nessuna documentazione per gli sviluppatori disponibile |
| Corvus Pay |
"gateway": "corvuspay" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Credit2000 |
"gateway": "credit2000" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID" |
| Credorax |
"gateway": "credorax" "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
|