Transazioni avviate dal commerciante (MIT)

Panoramica dell'assistenza per le 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 una maggiore visibilità per questi tipi di transazioni, un'esperienza utente migliorata grazie a un'interfaccia utente dedicata ai dettagli di fatturazione e una migliore continuità dei pagamenti.

Principali casi d'uso

  • Pagamenti ricorrenti: servizi di streaming digitale, abbonamenti o utenze.
  • Pagamenti differiti: prenotazioni di hotel, preordini o commissioni per mancato arrivo.
  • Ricariche automatiche: ricariche di valore memorizzato per carte regalo o per i trasporti.

Implementazione dell'API MIT

L'API MIT è un'estensione dell'API esistente LoadPaymentData . Gli integratori devono includere esattamente un oggetto *TransactionInfo per specificare l'intento di fatturazione. Google offre 3 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.
Differita DeferredTransactionInfo Utilizzato per un singolo addebito in un momento futuro predeterminato.
Ricarica automatica AutomaticReloadTransactionInfo Utilizzato per ricaricare un account con valore memorizzato quando un saldo scende al di sotto di una soglia minima.

Passaggi per l'integrazione

  1. Documentazione: accedi al sito per sviluppatori durante il programma di accesso in anteprima. Le tre nuove definizioni di oggetti si trovano nella sezione Riferimento 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 è possibile passare un solo oggetto per richiesta all'API. La determinazione dell'oggetto da utilizzare e la compilazione dei campi dipende dal singolo commerciante.
  3. Test: utilizza l'ambiente TEST per verificare che i dettagli di fatturazione vengano visualizzati correttamente nel foglio di pagamento.
  4. Lancio: vai in produzione 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 relativa alla 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 verifica quando il numero di conto principale di finanziamento sottostante viene aggiornato.

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 o 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 passato con la transazione per ricevere gli aggiornamenti del token. Per i PSP, la determinazione di come i commercianti riceveranno e compileranno questo URL nell'oggetto *TransactionInfo pertinente è di responsabilità del PSP.

Tieni presente inoltre che il payload criptato restituirà un campo facoltativo aggiuntivo, merchantTokenId, per le MIT. 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).