Выполнить транзакцию
Создает транзакцию A2C и отправляет средства на выбранную карту пользователя.
Конечная точка
http
POST {BASE_URL}/merchant/a2c/performTransaction/Заголовки
http
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/jsonТело запроса
| Поле | Тип | Требуется | Описание |
|---|---|---|---|
| amountInTiyin | integer | Да | Сумма перевода в тиыне |
| userId | string | Да | Пользователь ID заявлен мерчантом |
| cardId | string | Да | Карта ID создана в системе Paylov |
| externalId | string | Нет | Внешняя транзакция на стороне мерчанта ID |
json
{
"amountInTiyin": 2500000,
"userId": "string",
"cardId": "string",
"externalId": "string"
}Успешный ответ
json
{
"transactionId": "9bd1a92b-5cce-47c8-a2df-99a20836ab9e",
"status": "0",
"statusText": "SUCCESS"
}| Поле | Тип | Описание |
|---|---|---|
| transactionId | string | A2C транзакция ID |
| status | string | Код статуса транзакции |
| statusText | string | Человекочитаемый статус транзакции |
Ошибка ответа
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.
Полный справочник: Коды ошибок.