Стандартные платежи Google: карточный ФОП

Обзор

API Card FOP (форма оплаты) поддерживает платежи, осуществляемые с использованием стандартных карт. Это могут быть кредитные и дебетовые карты. Для платежей предусмотрен как поток одиночных, так и двойных сообщений.

Важные понятия

Символы и обозначения

Ключевые слова «ДОЛЖЕН», «НЕ ДОЛЖЕН», «ТРЕБУЕТСЯ», «ДОЛЖЕН», «НЕ ДОЛЖЕН», «СЛЕДУЕТ», «НЕ ДОЛЖЕН», «РЕКОМЕНДУЕТСЯ», «МОЖЕТ» и «ДОПОЛНИТЕЛЬНО» в этих документах: интерпретироваться, как описано в RFC 2119 .

Временные метки

Все временные метки представлены в миллисекундах с начала эпохи Unix в формате UTC.

Например:

  • 14 августа 2010 г., 16:30:00.00 GMT = 1281803400000
  • 6 ноября 2007 г., 21:37:00 MST = 1194410220000

Суммы

Денежные значения в этом API представлены в формате «микро», стандарте Google. Микро — это целочисленный формат с фиксированной точностью. Чтобы представить денежную стоимость в микромах, умножьте стоимость стандартной валюты на 1 000 000.

Например:

  • 1,23 доллара США = 1 230 000 микродолларов США
  • 0,01 доллара США = 10 000 микродолларов США

Идемпотентность

Все вызовы методов в этом API должны иметь идемпотентное поведение. Проще говоря, интеграторам не следует пытаться повторно обработать уже успешно обработанный запрос; вместо этого следует сообщить об успешной обработке. Все методы имеют общий RequestHeader, который содержит requestId. Этот requestId является ключом идемпотентности для всех вызовов.

Любой нетерминальный ответ (не HTTP 200) не должен обрабатываться идемпотентно. Таким образом, запрос, который ранее получил 400, при повторном вызове не должен идемпотентно возвращать 400, его необходимо переоценить. При повторной оценке он может вернуть 400 или быть успешно обработан.

Дополнительную информацию об идемпотентности смотрите в этом подробном руководстве .

Резервный поток захвата

Поток захвата резерва представляет собой поток из двух сообщений, в котором средства сначала резервируются, а затем захватываются. Во время резервирования движения денег не происходит. Затем бронирование можно отменить или захватить. Конечный результат захвата или отмены асинхронно возвращается в Google через уведомление.

Платежный интегратор реализует

Google реализует

Более подробную информацию о захвате резерва смотрите в этом подробном руководстве .

Поток перевода средств

Поток перевода средств представляет собой единый поток сообщений, в котором средства непосредственно фиксируются. Поток состоит из одного метода, реализованного интегратором платежей, с именем Capture . Этот метод синхронно проверяет наличие доступных средств и в случае успеха захватывает их.

Платежный интегратор реализует

Google реализует

Более подробную информацию о переводе средств смотрите в этом подробном руководстве .

Поток возврата

Поток возврата используется для возврата средств, которые ранее были получены посредством потока захвата резерва или потока перевода средств .

Платежный интегратор реализует

Google реализует

Дополнительную информацию о возмещении см. в этом подробном руководстве .

Ход споров

Ход спора . используется для информирования Google о спорах и возвратных платежах, когда клиент требует возмещения. Не каждый звонок подразумевает движение денег, но этот поток можно использовать для возврата средств клиенту или для отмены этого и возврата их обратно в Google. Этот поток можно использовать в дополнение к потоку сообщений о мошенничестве , но он не обязательно включает мошенничество.

Google реализует

Более подробную информацию о спорах смотрите в этом подробном руководстве .

Порядок сообщения о мошенничестве

Поток сообщений о мошенничестве предназначен для информирования Google о потенциальном мошенничестве. Эта информация не подразумевает никакого движения денег и просто используется для информирования системы рисков Google о событии, чтобы можно было уменьшить общее количество случаев мошенничества. Это может сопровождаться спором или возвратом платежа через поток споров .

Google реализует

Дополнительную информацию о сообщениях о мошенничестве см. в этом подробном руководстве .