Pagamenti standard Google: forma di pagamento carta

Panoramica

L'API Card FOP (Form of Payment) supporta i pagamenti effettuati tramite carte standard. Può trattarsi di carte di credito e di debito. C'è un singolo flusso di messaggi con doppio messaggio fornito per i pagamenti.

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 delle prenotazioni è un flusso di due messaggi in quali fondi vengono prenotati per la prima volta e poi acquisiti in un secondo momento. Durante la prenotazione non avviene alcun movimento di denaro. A questo punto, la prenotazione può essere annullata o acquisita. La il risultato finale dell'acquisizione o dell'annullamento viene restituito in modo asincrono a Google. tramite una notifica.

L'Integratore dei pagamenti implementa

Google implementa

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

Flusso di trasferimento di fondi

Il flusso di trasferimento di fondi è un flusso di messaggi singoli in quali fondi vengono acquisiti direttamente. Il flusso è composto da un singolo metodo che è implementato dall'integratore pagamenti denominato Capture. Questo metodo controlla in modo sincrono i fondi disponibili e acquisisce i fondi in caso di esito positivo.

L'Integratore dei pagamenti implementa

Google implementa

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

Flusso di rimborso

Il flusso di rimborso viene utilizzato per restituire i fondi che sono stati precedentemente acquisite tramite il flusso di acquisizione della prenotazione o 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 della contestazione. viene utilizzato per informare Google di controversie e storni di addebito in cui il cliente richiede un rimborso. Non tutte le chiamate implica un movimento di denaro, ma questo flusso può essere utilizzato per restituire fondi a un cliente, o invertirlo e restituirlo a Google. Questo flusso può essere utilizzato oltre al flusso per la segnalazione di attività fraudolente, ma non includono necessariamente le frodi.

Google implementa

Per ulteriori informazioni sulle contestazioni, consulta questa guida dettagliata.

Flusso di segnalazione delle frodi

Il flusso di segnalazione di attività fraudolente serve a informare Google del delle attività fraudolente. Queste informazioni non implicano movimenti di denaro e sono utilizzati per informare dell'evento il motore dei rischi di Google, in modo che possono essere ridotti. Ciò può essere accompagnato da una contestazione o uno storno di addebito tramite flusso delle contestazioni.

Google implementa

Per ulteriori informazioni sulla segnalazione di frodi, visita guida dettagliata.