Payments

CallBack при подтверждении холдирования

Пример запроса для hold-confirm

После подтверждения удержания

{
  "method": "notify",
  "params": {
    "external_transaction_id": "1234",
    "transaction_id": "01J2ZWPPP4W1DD1BPTMGV3KFEY",
    "card_token": "d4f7a9b2-3e1b-4c86-91ce-7f4a8a3d6e99",
    "card_number": "860002******2429",
    "processing_type": 5
  }
}

Свойства запроса

Поле	Тип	Описание
external_transaction_id	String	Внешний идентификатор платежа (Айди у партенра)
transaction_id	String	Уникальный идентификатор платежа в Beepul
card_token	String	Токен карты по которой была совершена оплата
card_number	String	Номер карты в маскированном формате
processing_type	Integer	Процессинг

CallBack на метод оплаты

Пример запроса для pay

После успешной оплаты

❗ Если оплата не была холдирована

{
  "method": "notify",
  "params": {
    "external_transaction_id": "1234",
    "transaction_id": "01J2ZWPPP4W1DD1BPTMGV3KFEY",
    "card_token": "d4f7a9b2-3e1b-4c86-91ce-7f4a8a3d6e99",
    "card_number": "860002******2429",
    "processing_type": 5
  }
}

Свойства запроса

Поле	Тип	Описание
external_transaction_id	String	Внешний идентификатор платежа (Айди у партенра)
transaction_id	String	Уникальный идентификатор платежа в Beepul
card_token	String	Токен карты по которой была совершена оплата
card_number	String	Номер карты в маскированном формате
processing_type	Integer	Процессинг

CallBack при изменение статуса

Пример запроса для change-state

Изменение статуса платежа

{
  "method": "paymentChangeState",
  "params": {
    "externalTransactionId": "externalPartnerId",
    "ulidId": "01J2ZWPPP4W1DD1BPTMGV3KFEY",
    "oldState": 0,
    "newState": 4,
    "updateTime": "2025-07-30T11:00:00Z"
  }
}

Свойства запроса

Поле	Тип	Описание
externalTransactionId	String	Внешний идентификатор платежа (Айди у партенра)
ulidId	String	Уникальный идентификатор платежа в Beepul
oldState	Integer	Прошлый статус платежа
newState	Integer	Новый статус платежа
updateTime	DateTime	Время изменения

CallBack при неуспешном платеже

Пример запроса для failNotify

При неуспешной оплате

{
  "method": "failNotify",
  "params": {
    "externalTransactionId": "1234",
    "transactionId": "01J2ZWPPP4W1DD1BPTMGV3KFEY",
    "errorCode": "-60603"
  }
}

Свойства запроса

Поле	Тип	Описание
externalTransactionId	String	Внешний идентификатор платежа (ID у партнёра)
transactionId	String	Уникальный идентификатор платежа в Beepul (ULID)
errorCode	String	Код ошибки (см. Обработка ошибок)