Pagamenti standard Google: forma di pagamento carta

Panoramica

L'API Card FOP (Form of Payment) supporta i pagamenti effettuati con carte standard. Possono essere carte di credito e di debito. Per i pagamenti è previsto un flusso per messaggi singoli e doppi.

Concetti importanti

Simboli e convenzioni

Le parole chiave "DEVE", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" e "OPTIONAL" in questi documenti devono essere interpretate come descritto in RFC 2119.

Timestamp

Tutti i timestamp sono rappresentati in millisecondi dall'epoca di Unix nel fuso orario UTC.

Ad esempio:

  • 14 agosto 2010 16:30:00 GMT = 1281803400000
  • 6 novembre 2007 21:37:00 MST = 1194410220000

Importi

I valori monetari in questa API sono rappresentati utilizzando un formato chiamato "micros", uno standard di Google. I micro sono un formato a precisione fissa basato su numeri interi. Per rappresentare un valore monetario in micro, moltiplica il valore della valuta standard per 1.000.000.

Ad esempio:

  • 1,23 USD = 1230000 micro USD
  • 0,01$= 10.000 micro USD

Idempotenza

Tutte le chiamate al metodo all'interno di questa API devono avere un comportamento idempotente. In parole povere, gli integratori non devono tentare di rielaborare le richieste già elaborate correttamente; la risposta per l'elaborazione riuscita deve essere invece registrata. Tutti i metodi hanno un'intestazione richiesta comune che contiene un ID richiesta. Questo requestId è la chiave di idempotenza per tutte le chiamate.

Per qualsiasi risposta non terminale (non HTTP 200), non deve essere elaborata in modo idempotente. Quindi una richiesta che in precedenza riceveva 400, quando chiamata una seconda volta non deve restituire idempotentemente 400, deve essere rivalutata. Al momento della nuova valutazione, potrebbe restituire un valore 400 o essere elaborato correttamente.

Per ulteriori informazioni sull'idempotenza, consulta questa guida dettagliata.

Prenota flusso di acquisizione

Il flusso di acquisizione della prenotazione è un flusso di due messaggi in cui i fondi vengono prima riservati e poi acquisiti in seguito. Durante la prenotazione non avviene alcuno spostamento di denaro. La prenotazione può quindi essere annullata o acquisita. Il risultato finale dell'acquisizione o dell'annullamento viene restituito a Google in modo asincrono tramite una notifica.

L'integratore dei pagamenti implementa

Google implementa

Per ulteriori informazioni sull'acquisizione delle prenotazioni, consulta questa guida dettagliata.

Flusso di trasferimento di fondi

Il flusso di trasferimento di fondi è un singolo flusso di messaggi in cui i fondi vengono acquisiti direttamente. Il flusso è composto da un singolo metodo implementato dall'integratore dei pagamenti denominato Capture. Questo metodo verifica in modo sincrono la disponibilità di fondi e, in caso di esito positivo, acquisisce i fondi.

L'integratore dei pagamenti implementa

Google implementa

Per ulteriori informazioni sul trasferimento di fondi, consulta questa guida dettagliata.

Flusso di rimborso

Il flusso di rimborso viene utilizzato per restituire i fondi precedentemente acquisiti tramite il flusso di acquisizione delle prenotazioni o il flusso di trasferimento di fondi.

L'integratore dei pagamenti implementa

Google implementa

Per ulteriori informazioni sui rimborsi, consulta questa guida dettagliata.

Flusso delle contestazioni

Il flusso delle contestazioni viene utilizzato per informare Google in merito a contestazioni e storni di addebito in cui il cliente richiede il rimborso. Non tutte le chiamate implicano il trasferimento di denaro, ma questo flusso può essere utilizzato per restituire fondi a un cliente o per invertire la transazione e restituirla a Google. Questo flusso può essere utilizzato in aggiunta al flusso per la segnalazione di attività fraudolente, ma non include necessariamente attività fraudolente.

Google implementa

Per ulteriori informazioni sulle contestazioni, consulta questa guida dettagliata.

Flusso di segnalazione di attività fraudolente

Il flusso di segnalazione delle attività fraudolente serve a informare Google di potenziali attività fraudolente. Queste informazioni non implicano alcun movimento di denaro e vengono utilizzate semplicemente per informare il Risk Engine di Google dell'evento, in modo da ridurre le attività fraudolente in generale. Ciò può essere accompagnato da una contestazione o uno storno di addebito tramite il flusso delle contestazioni.

Google implementa

Per ulteriori informazioni sulla segnalazione di attività fraudolente, consulta questa guida dettagliata.