Метод deposit-to-token

URL: POST - /partner/transfer/deposit-to-token

Метод позволяет пополнять банковскую карту клиента с депозита партнера денежными средствами по токену и получать результат выполнения запроса в формате JSON.

На депозите партнера должно быть достаточно средств для пополнения банковской карты клиента перед выполнением запроса.

Параметры Заголовков

Свойство	Тип	Описание
client-id *	авторизация	Уникальный идентификатор партнера
client-secret *	авторизация	Уникальный ключ аутентификации к API VIA

Параметры запроса

Имя	Тип	Описание
externalId *	string	Уникальный идентификатор запроса партнера
amount *	integer	Сумма пополнения в тийинах, центах и т.д. (1/100 часть базовой единицы валюты)
sender *	object	Объект данных отправителя
sender.firstName *	string	Имя отправителя
sender.lastName *	string	Фамилия отправителя
sender.middleName *	string	Отчество отправителя
receiverToken *	string	Токен банковской карты в системе
currency *	string	Валюта: «UZS» - узбекский сум «USD» - Доллары США
note *	string	Текст примечания, заметки и т.д.

Пример запроса

curl POST '/partner/transfer/deposit-to-token' \
--header 'client-id: system' \
--header 'client-secret: system123' \
--data '{
    "externalId": "string",
    "amount": 1000,
    "sender": {
        "firstName": "John",
        "lastName": "Doe",
        "middleName": "Smith"
    },
    "receiverToken": "VLH8VNWKE3SBBBZEKA86T5PF72ZNVOIC",
    "currency": "UZS",
    "note": "P2P for card"
}'

Параметры ответа

Имя	Тип	Описание
data	object	Объект данных ответа
transactionId	object	Идентификатор транзакции
note	string	Текст примечания, заметки и т.д.
externalId	string	Идентификатор запроса партнера
processPayerTransactionId	string	Идентификатор транзакции системы процессинга отправителя
processReceiverTransactionId	string	Идентификатор транзакции системы процессинга получателя
merchantId	string	Идентификатор мерчанта VIA
status	string	Статус транзакции: «SUCCESS» - Успешно «ERROR» - Ошибка «REJECT» - Отказано «PENDING» - Запрос в ожидании «NEW» - Отправлен новый запрос «DRAFT» - Запрос на стадии формирования
amount	integer	Сумма перевода в тийинах, центах и т.д.
fee	integer	Сумма комиссии в тийинах, центах и т.д.
feePercent	long	Сумма комиссии в процентах
currency	string	Валюта: «UZS» - узбекский сум
errorCode	string	Код ошибки
errorMessage	string	Описание ошибки
refundedAmount	integer	Сумма возврата в тийинах, центах и т.д.
modifiedAt	integer	Дата и время обновления транзакции в формате Unix Timestamp
createdAt	integer	Дата и время создания транзакции в формате Unix Timestamp
payedAt	integer	Дата и время оплаты в формате Unix Timestamp
process	string	Тип процессинга «UZCARD» «HUMO»
epos	object	Объект данных системы EPOS
epos.merchantId	string	Идентификатор мерчанта
epos.terminalId	string	Идентификатор терминала

Пример ответа в случае успеха

{
    "data": {
        "transactionId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ",
        "note": «sample request»,
        "externalId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ",
        "processPayerTransactionId": "bw_2TEt8UFOloG4VZevOGT4OQThhuF",
        "processReceiverTransactionId": "trx_2isdflkUHuh98237KJhw87",
        "merchantId": "terrx_2TEt8TonK6VhrewD78Wv0QXu",
        "status": "SUCCESS",
        "amount": 100000,
        "fee": 0,
        "feePercent": 0,
        "currency": "UZS",
        "errorCode": "",
        "errorMessage": "",
        "refundedAmount": 0,
        "modifiedAt": 0,
        "createdAt": 0,
        "payedAt": 0,
        "process": "UZCARD",
        "epos": {
            "merchantId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ",
            "terminalId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ"
        }
    }
}

Пример ответа в случае ошибки

{
    "status": {
    "code": "1234",
    "message": "Ошибка при выполнении запроса"
    },
    "error": {
        "path": "URL Path",
        "message": {
            "uz": "Error message in Uzbek",
            "ru": "Error message in Russian",
            "en": "Error message in English"
        }
    }
}