Tarlanpayments
Рус
Рус
  • Платежный шлюз
    • Общая информация
      • Процесс одностадийного платежа
      • Процесс двухстадийного платежа
      • Виды операций
      • 3D-Secure
      • PCI DSS
    • Типы транзакций
    • Структура ответов системы
    • Коды ошибок
    • Статусы транзакций
    • Формирование подписи
    • Дополнительные параметры
    • Взаимодействие с формой оплаты
      • Инициация приёма денежных средств
      • Инициация вывода денежных средств
      • Привязка карты
      • Инициация приёма денежных средств посредством Apple Pay
      • Инициация приёма денежных средств посредство Google Pay
      • Iframe
    • Платежи без формы оплаты
      • Платеж по сохраненной карте (one click)
      • Вывод денежных средств (pay-out)
      • Шифрование платежной карты
    • Вспомогательные методы
      • Удаление привязанной карты
      • Проверка статуса транзакции
      • Получение списка карт
      • Возврат платежа
      • Расчет верхней комиссии
      • Подтверждение списания средств
      • Отмена списания средств
    • Webhook платежной системы
      • Статус оплаты
      • Готовность проведения оплаты
    • Smart Pay
      • Google pay
    • CMS
      • WordPress
      • Bitrix
      • Tilda
    • Сводка изменений
  • AGWS
    • Коды состояния аккаунта
    • Статусы транзакции
    • Коды ошибок
    • Причина отклонения операции
    • Время жизни транзакции
    • Формирование подписи
    • Проверка состояния аккаунта
    • Проведение платежа
    • Проверка статуса пополнения
    • Проверка остатка баланса на счету
    • Подтверждение списания средств
    • Создание ссылки на оплату
    • Информация по услугам
    • Получение информации о юзере
    • Callback платежной системы
  • Получение фискального чека
  • Расчет верхней комиссии
Powered by GitBook
On this page
  • Backoff Policy
  • Отправка callback-a проект партнера
  1. Платежный шлюз
  2. Webhook платежной системы

Статус оплаты

Метод предназначен для оповещения системы проекта о статусе платежа.

Backoff Policy

Для увеличения гарантий получения ответа используются BackOff-политики при выполнении запросов:

  • InitialInterval = 500 * time.Millisecond, интервалы между повторными запросами

  • RandomizationFactor = 0.5, Разброс запроса по времени между повторами

  • MaxInterval = 60 * time.Second, Максимальное время между повторами

  • MaxElapsedTime = 10 * time.Minute, время в течении которого будут выполнены попытки

Callback платежной системой после каждой операции

После завершения оплаты, платежная система делает запрос в проект партнера для передачи состояния платежа. Запрос делается на адрес указанный в поле callback_url при инициации платежа.

При получении http статуса отличного от 200 транзакция будут выполнены BackOff политики

Отправка callback-a проект партнера

POST callback_url

Headers

Name
Type
Description

Authorization*

String

Request Body

Name
Type
Description

created_at*

String

Дата создания транзакции

transaction_id*

Integer

Идентификатор транзакции на стороне платежной системы

acquirer_code*

String

Идентификатор банка

project_reference_id*

String

Идентификатор транзакции на стороне проекта

project_сlient_id*

String

Идентификатор пользователя на стороне проекта

status_code*

String

type_code*

String

amount*

Float

Сумма транзакции

description*

String

Описание

finished_at*

String

Дата завершения транзакции

project_id*

Integer

Идентификатор проекта

merchant_id*

Integer

Идентификатор мерчанта

additional_data

Object

Дополнительные поля

card_token

String

Токен карты в платежной системе

masked_pan

String

Маскированная карта платежа

bank_code

String

bank_message

String

Описание ошибки

ips

String

МПС система (visa/mastercard...)

issuer

String

Эмитент карты

{
  "created_at": "2023-12-25T16:04:26.611025Z",
  "finished_at": "2023-12-25T16:05:47.672271Z",
  "transaction_id": 999,
  "acquirer_code": "jusan",
  "project_id": 999,
  "merchant_id": 999,
  "project_reference_id": "121adsf",
  "project_client_id": "12dfsd",
  "card_token": "qkRCjlJrAmbL7RMIqeS1OHGYLJpEbf7toQo/2zk+/8zCyaiQ",
  "masked_pan": "0000-00XXXXXX-0000",
  "year": "24",
  "month": "12",
  "ips": "",
  "issuer": "JSC ALLIANCE BANK",
  "status_code": "success",
  "type_code": "in",
  "amount": 100,
  "description": "Оплата заказа",
  "additional_data": {}
}

Last updated 11 months ago

Bearer Авторотационный хэш (см )

передается в случае ошибки в транзакции

Формирование подписи
Статус транзакции
Тип транзакции
Код ошибки