Payments

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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