Фиатные платежи

В данном разделе представлено описание и перечень методов для работы с фиатными платежными методами и получения фиатных платежей.

Основная последовательность действий

1. Запрос доступных платежных методов (/fiat/get-payment-methods): Наш API позволяет партнерам начать интеграцию с запроса списка всех доступных методов оплаты. Этот запрос предоставляет информацию о том, какие методы доступны для оплаты. Каждый метод оплаты может иметь различные дополнительные поля, необходимые для выполнения платежа, такие как выбор банка или другие специфические параметры.

2. Создание платежа (POST /fiat/create-payment): После выбора метода оплаты партнер отправляет запрос на создание платежа. В этом запросе указывается gatewayId (идентификатор метода оплаты) и, если необходимо, дополнительные поля, связанные с выбранным методом оплаты. Эти поля зависят от метода и могут включать в себя информацию о выбранном банке или другие параметры.

3. Ответ на создание платежа: Наш API возвращает информацию о платеже в ответ на запрос создания платежа. Это включает в себя статус платежа и дополнительную информацию о платеже, доступную в поле "extra". Эта информация должна быть отображена партнером для конечного плательщика, например, номер карты и название банка.

4. Подтверждение платежа (/fiat/confirm-payment): Когда конечный пользователь успешно оплачивает платеж, партнер предоставляет кнопку "Я оплатил" или аналогичный механизм. Затем партнер вызывает метод API для подтверждения платежа (confirm-payment). Этот запрос сообщает нашему API о том, что платеж успешно оплачен пользователем.

5. Отмена платежа (/fiat/cancel-payment): Если конечный пользователь отказывается от платежа, партнер вызывает соответствующий метод API (cancel-payment). Это сообщает нашему API о том, что платеж должен быть отменен.

6. Вебхуки: Наша система будет отправлять вебхуки на указанный при создании платежа webhookUrl после получения финального статуса платежа или на этапах подтверждения или отмены. Вебхуки содержат информацию о статусе платежа и могут быть использованы партнером для обновления информации в его системе или на сайте.

Webhook

При изменении статуса платежа на указанный URL будут приходить уведомления об изменении статуса Тело вебхука будет идентично телу ответа создания/получения платежа

Вебхук будет отправлен со следующими заголовками:

Заголовк	Описание
x-api-public-key	Публичный ключ, с помощью которого был создан платеж
x-api-signature	Подпись запроса (составляется по аналогии с подписью запросов)
x-event-time	Дата события в формате ISO 8601 (RFC3339)

{
    "id": "133",
    "gatewayId": "12",
    "status": "PENDING",
    "extra": {
      "accountNumber": "2222222222222222",
      "accountName": "Иванов Иван Иванович",
      "bankName": "bank"
    },
    "paymentCurrency": "RUB",
    "paymentAmount": "4990",
    "destinationCurrency": "USDT",
    "destinationAmount": "string",
    "createdAt": "2023-09-26T13:29:34.172Z"
}

Коды ошибок

Текущий список кодов ошибок дополняет основной список кодов ошибок

Код	Описание
4001	Передан некорректный или несуществующий идентификатор шлюза
4002	Не переданы обязательные поля для создания платежа
4003	Указанный платеж не найден
4004	Платеж уже подтвержден
4005	Платеж уже отменен
4006	Передана некорректная сумма или сумма меньше минимальной для выбранного шлюза
4007	Передано некорректное значения для времени жизни платежа
4008	Передано некорректное значение в поле для создания платежа
4009	Передан некорректный идентификатор платежа
4010	Депозит имеет неподходий статус для данной операции
4011	Прием оплат для данного шлюза в данный момент невозможен. Возможно слишком много активных платежей, дождитесь их завершения или свяжитесь с поддержкой