Перейти к основному содержимому

Метод deposit-to-card

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

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

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

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

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

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

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

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

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

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

ИмяТипОписание
dataobjectОбъект данных ответа
transactionIdobjectИдентификатор транзакции
notestringТекст примечания, заметки и т.д.
externalIdstringИдентификатор запроса партнера
processPayerTransactionIdstringИдентификатор транзакции системы процессинга отправителя
processReceiverTransactionIdstringИдентификатор транзакции системы процессинга получателя
merchantIdstringИдентификатор мерчанта VIA
statusstringСтатус транзакции:
«SUCCESS» - Успешно
«ERROR» - Ошибка
«REJECT» - Отказано
«PENDING» - Запрос в ожидании
«NEW» - Отправлен новый запрос
«DRAFT» - Запрос на стадии формирования
amountintegerСумма перевода в тийинах, центах и т.д.
feeintegerСумма комиссии в тийинах, центах и т.д.
feePercentlongСумма комиссии в процентах
currencystringВалюта:
«UZS» - узбекский сум
errorCodestringКод ошибки
errorMessagestringОписание ошибки
refundedAmountintegerСумма возврата в тийинах, центах и т.д.
modifiedAtintegerДата и время обновления транзакции в формате Unix Timestamp
createdAtintegerДата и время создания транзакции в формате Unix Timestamp
payedAtintegerДата и время оплаты в формате Unix Timestamp
processstringТип процессинга
«UZCARD»
«HUMO»
eposobjectОбъект данных системы EPOS
epos.merchantIdstringИдентификатор мерчанта
epos.terminalIdstringИдентификатор терминала

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

{
"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"
}
}
}