Skip to content

Выполнить транзакцию ​

Создает транзакцию A2C и отправляет средства на выбранную карту пользователя.

Конечная точка ​

http
POST {BASE_URL}/merchant/a2c/performTransaction/

Заголовки ​

http
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

Тело запроса ​

ПолеТипТребуетсяОписание
amountInTiyinintegerДаСумма перевода в тиыне
userIdstringДаПользователь ID заявлен мерчантом
cardIdstringДаКарта ID создана в системе Paylov
externalIdstringНетВнешняя транзакция на стороне мерчанта ID
json
{
  "amountInTiyin": 2500000,
  "userId": "string",
  "cardId": "string",
  "externalId": "string"
}

Успешный ответ ​

json
{
  "transactionId": "9bd1a92b-5cce-47c8-a2df-99a20836ab9e",
  "status": "0",
  "statusText": "SUCCESS"
}
ПолеТипОписание
transactionIdstringA2C транзакция ID
statusstringКод статуса транзакции
statusTextstringЧеловекочитаемый статус транзакции

Ошибка ответа ​

json
{
  "result": null,
  "error": {
    "code": "insufficient_funds",
    "message": "There are insufficient funds on the card."
  }
}

Коды ошибок ​

Ошибки процессинга возвращаются как конкретные унифицированные коды (например insufficient_funds, card_expired, card_not_active, limit_exceeded, card_is_not_supported) с английским message. Сырые коды/текст процессинга не раскрываются.

Специфично для A2C:

  • permission_denied — мерчанту не разрешён A2C (или A2C по PAN — требуется uses_a2c_by_pan).
  • card_not_found, card_not_active, phone_not_match, insufficient_deposit.
  • Проверки личности (когда включены is_myid_required / is_pinfl_required): official_profile_required, merchant_user_myid_not_verified, pinfl_check_required, pinfl_not_match.
  • card_temporarily_blocked — блокировка анти-фродом; data.blocked_until, data.reason.

Полный справочник: Коды ошибок.