Standardowe płatności Google: forma płatności karty

Omówienie

Interfejs API FOP (Form of Payment) obsługuje płatności dokonywane za pomocą standardowych kart. Mogą to być karty kredytowe lub debetowe. Występują zarówno obsługa 2 wiadomości w przypadku płatności.

Ważne pojęcia

Symbole i konwencje

Słowa kluczowe w tych dokumentach: „MUSZ”, „MUSZ NOT”, „REQUIRED”, „SHALL”, „SHALL NOT”, „SHOULD”, „POWINNO”, „ZALECANE”, „MAY” i „OPCJONALNE” w tych dokumentach należy interpretować w sposób opisany w dokumencie RFC 2119.

Sygnatury czasowe

Wszystkie sygnatury czasowe są podawane w milisekundach od początku epoki uniksowej w strefie czasowej UTC.

Na przykład:

  • 14 sierpnia 2010 r. 16:30:00.00 GMT = 1281803400000
  • 6 listopada 2007 r., 21:37:00 czasu MST = 1194410220000

Kwoty

Wartości pieniężne w tym interfejsie API są przedstawiane w formacie „micros”, który jest standardem Google. Mikro to format o stałej dokładności, który jest oparty na liczbie całkowitej. Aby podać wartość pieniężną w mikro, pomnóż standardową wartość w walucie przez 1 000 000.

Na przykład:

  • 1,23 USD = 123 000 mikro USD
  • 0,01 USD = 10 000 mikro USD

Idempotentność

Wszystkie wywołania metod w tym interfejsie API muszą mieć działanie idempotentne. Mówiąc najprościej, integrator nie powinien próbować ponownie przetworzyć żadnego już przetworzonego żądania. Zamiast tego powinna być raportowana odpowiedź dotycząca udanego przetwarzania. Wszystkie metody mają wspólny nagłówek RequestHeader, który zawiera identyfikator requestId. Ten identyfikator żądania to klucz idempotentności wszystkich wywołań.

Odpowiedź niekońcowa (inna niż HTTP 200) nie może być przetwarzana idempotentnie. Dlatego żądanie, które wcześniej otrzymało kod 400, a wywołanie go po raz drugi, nie może zwrócić idempotentnie wartości 400 – musi zostać ponownie sprawdzone. Podczas ponownej oceny raport może zwrócić błąd 400 lub zostać przetworzony.

Więcej informacji na temat idempotentności znajdziesz w tym szczegółowym przewodniku.

Proces przechwytywania rezerwacji

Proces przechwytywania rezerwacji to 2 przepływy wiadomości: które środki są najpierw rezerwowane, a później przechwytywane. W trakcie rezerwacji nie ma żadnego przepływu pieniędzy. Rezerwacja można wtedy anulować lub zapisać. końcowy wynik przechwytywania lub anulowania jest zwracany asynchronicznie do Google w powiadomieniu.

Integrator płatności implementuje

Google stosuje

Więcej informacji o rejestrowaniu rezerwacji znajdziesz tutaj szczegółowym przewodniku.

Proces transferu środków

Przepływ środków to jedna wiadomość: które są odbierane bezpośrednio. Przepływ składa się z jednej metody, która jest zaimplementowana przez integratora płatności o nazwie Capture. Ta metoda synchronicznie sprawdza dostępne środki i w przypadku powodzenia przechwytuje je.

Integrator płatności implementuje

Google stosuje

Więcej informacji o transferze środków znajdziesz tutaj szczegółowego przewodnika.

Procedura zwrotu środków

Procedura zwrotu środków służy do zwrotu środków, które zostały dokonane wcześniej. przechwycone za pomocą procesu przechwytywania rezerwacji lub proces transferu środków.

Integrator płatności implementuje

Google stosuje

Więcej informacji na temat zwrotów środków można znaleźć w tym szczegółowym przewodniku.

Procedura dotycząca sporów

Procedura zgłaszania sprzeciwu. służy do informowania Google o sporach oraz w przypadku których klient domaga się zwrotu kosztów. Nie każde połączenie oznacza przepływ pieniężny, ale ten proces można wykorzystać do zwrócenia środków klientowi, lub odwrócić tę informację i zwrócić je z powrotem do Google. Tego procesu można użyć w: oprócz zgłaszania oszustw, ale nie musi obejmować oszustwo.

Google stosuje

Więcej informacji o sporach znajdziesz w tym szczegółowym przewodniku.

Proces zgłaszania oszustw

Zgłaszanie oszustw ma na celu poinformowanie Google potencjalne oszustwo. Te informacje nie oznaczają przepływu pieniędzy i są były używane tylko do informowania mechanizmu Google Risk Engine o zdarzeniu, co pozwala zapobiegać oszustwom można zmniejszyć. Może to spowodować spór lub obciążenie zwrotne proces zgłaszania sprzeciwu.

Google stosuje

Więcej informacji o zgłaszaniu oszustw znajdziesz na tej stronie szczegółowym przewodniku.