Transazioni avviate dal commerciante (MIT)

Panoramica dell'assistenza MIT

Le transazioni avviate dal commerciante (MIT) sono transazioni elaborate senza che l'utente sia attivo nella sessione. Questo aggiornamento dell'API Google Pay Online offre una maggiore visibilità per questi tipi di transazione, 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 digitale, abbonamenti o utenze.
  • Pagamenti differiti: prenotazioni di hotel, preordini 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 . 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 di prove, prepagata e postpagata.
Differito DeferredTransactionInfo Utilizzato per un singolo addebito in un momento futuro predeterminato.
Ricarica automatica AutomaticReloadTransactionInfo Utilizzato per ricaricare un conto con valore memorizzato quando il saldo scende al di sotto di una soglia minima.

Passaggi per l'integrazione

  1. Documentazione:accedi a DevSite durante il programma di accesso in anteprima. Le tre nuove definizioni di oggetti si trovano nella sezione Riferimento agli oggetti e sono collegate direttamente nell'elenco precedente.
  2. Implementazione:utilizza gli oggetti *TransactionInfo pertinenti per il tuo sistema nella richiesta API.
    • Tieni presente che può essere passato un solo oggetto per richiesta all'API. La determinazione dell'oggetto da utilizzare e la compilazione dei campi spetta al singolo commerciante.
  3. Test:utilizza l'ambiente TEST per verificare che i dettagli di fatturazione vengano visualizzati correttamente nella busta paga.
  4. Lancio:inizia la trasmissione dal vivo 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 chiave dei token

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

Requisiti di 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 del 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, la determinazione di come i commercianti riceveranno e compileranno questo URL nell'oggetto *TransactionInfo pertinente è responsabilità del PSP.

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).