Transazioni avviate dal commerciante (MIT)

Panoramica dell'assistenza per MIT

Le transazioni avviate dal commerciante (MIT) sono transazioni elaborate senza che l'utente sia attivamente in sessione. Questo aggiornamento dell'API Google Pay Online offre maggiore visibilità per questi tipi di transazioni, un'esperienza utente migliorata grazie a un'esperienza utente dedicata ai dettagli di fatturazione e una migliore continuità dei pagamenti.

Casi d'uso principali

  • Pagamenti ricorrenti:servizi di streaming digitali, abbonamenti o utenze.
  • Pagamenti differiti:prenotazioni di hotel, prenotazioni o commissioni per mancato arrivo.
  • Ricariche automatiche:ricariche del valore memorizzato per il trasporto pubblico o le carte regalo.

Implementazione dell'API MIT

L'API MIT è un'estensione dell'API LoadPaymentData esistente. Gli integratori devono includere esattamente un oggetto *TransactionInfo per specificare l'intento di fatturazione. Google offre tre opzioni a seconda del tipo di transazione avviata dal commerciante:

Tipo di transazione Nome oggetto Descrizione
Ricorrente RecurringTransactionInfo Utilizzato per gli addebiti a frequenza fissa. Supporta la fatturazione per prove, prepagata e postpagata.
Differito DeferredTransactionInfo Utilizzato per un singolo addebito in un momento futuro prestabilito.
Ricarica automatica AutomaticReloadTransactionInfo Utilizzato per ricaricare un account con valore memorizzato quando il saldo scende al di sotto di una soglia minima.

Passaggi per l'integrazione

  1. Documentazione:le tre nuove definizioni di oggetti si trovano nella sezione Riferimento agli oggetti della documentazione e sono collegate direttamente nell'elenco precedente.
  2. Implementazione:utilizza gli oggetti *TransactionInfo pertinenti per il tuo sistema nella richiesta API.
    • Tieni presente che è possibile passare un solo oggetto per richiesta all'API. La determinazione dell'oggetto da utilizzare e il completamento dei campi spetta al singolo commerciante.
  3. Test:utilizza l'ambiente TEST per verificare che i dettagli di fatturazione vengano visualizzati correttamente nella scheda paga.
  4. Lancio:vai live una volta verificati i parametri.

Gestione del ciclo di vita dei token (TLM)

La gestione del ciclo di vita dei token garantisce la continuità dei pagamenti fornendo notifiche in tempo reale quando i token di pagamento sicuri vengono aggiornati o disattivati. Per tutti i dettagli, consulta la documentazione sulla gestione del ciclo di vita dei token .

Eventi dei token chiave

  • Disattivazione/Eliminazione:notifica quando un token non è più utilizzabile.
  • Aggiornamenti del suffisso FPAN: si verificano quando il numero del conto principale di finanziamento sottostante viene aggiornato.

Requisiti per la configurazione del server

I commercianti diretti e i fornitori di servizi di pagamento (PSP) devono stabilire un sistema per ricevere, decriptare ed elaborare questi messaggi.

Requisito Descrizione
Endpoint Endpoint HTTPS sicuro per ricevere chiamate POST.
Autenticazione Deve gestire la convalida della firma e la decriptazione dei messaggi.
Risposta Restituisci SUCCESS per continuare a ricevere le notifiche oppure TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE per interromperle.
Notifica al commerciante I PSP dovranno comunicare lo stato del token ai propri commercianti.

Note sull'implementazione

L'endpoint tokenUpdateUrl deve essere trasmesso con la transazione per ricevere gli aggiornamenti per il token. Per i PSP, è responsabilità del PSP definire in che modo i commercianti riceveranno e compileranno questo URL nell'oggetto *TransactionInfo pertinente.

Tieni presente inoltre che il payload criptato restituirà un campo facoltativo aggiuntivo, merchantTokenId, per gli intent incorporati. Per dettagli specifici, consulta la documentazione relativa alla crittografia dei dati di pagamento (per i commercianti) o la documentazione relativa alla struttura del payload (per i PSP).