Метод Token2Pan

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

Метод позволяет партнёрам осуществлять переводы денежных средств между банковскими картами, используя уникальный токен карты отправителя и номер банковской карты получателя.

Для получения токена банковской карты используется метод /partner/card. (Для подробной информации смотрите соответствующую инструкцию)

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

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

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

Имя	Тип	Описание
senderToken *	string	Уникальный токен банковской карты отправителя
receiverPan *	string	Номер банковской карты получателя
amount *	integer	Сумма пополнения в тийинах, центах и т.д. (1/100 часть базовой единицы валюты)
note	string	Текст примечания, заметки и т.д.

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

curl POST '/partner/transfer/token-to-pan' \
  --header 'client-id: system' \
  --header 'client-secret: system123' \
  --data '{
      "senderToken": "ASDPT6OBAWWTD3TKZVVSNIENUPUQVOQO",
      "receiverPan": "8600123412341234"
      "amount": 10000,
      "note": ""
  }'

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

Имя	Тип	Описание
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"
        }
    }
}