Account2Card

Account2Card используется для перевода денег с банковского счета компании на счет пользователя. банковская карта. Этот поток позволяет мерчанту отправлять средства на карту, которая ранее была созданный в системе Paylov.

Формат суммы

Все суммы A2C отправляются и возвращаются в тиин. Например, 2500000 означает 25,000.00 UZS.

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

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

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

POST {BASE_URL}/merchant/a2c/performTransaction/

Заголовки

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

Тело запроса

Поле	Тип	Требуется	Описание
amountInTiyin	integer	Да	Сумма перевода в тиыне
userId	string	Да	Пользователь ID заявлен мерчантом
cardId	string	Да	Карта ID создана в системе Paylov
externalId	string	Нет	Внешняя транзакция на стороне мерчанта ID

{
  "amountInTiyin": 2500000,
  "userId": "string",
  "cardId": "string",
  "externalId": "string"
}

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

{
  "transactionId": "9bd1a92b-5cce-47c8-a2df-99a20836ab9e",
  "status": "0",
  "statusText": "SUCCESS"
}

Поле	Тип	Описание
transactionId	string	A2C транзакция ID
status	string	Код статуса транзакции
statusText	string	Человекочитаемый статус транзакции

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

{
  "result": null,
  "error": {
    "code": "processing_error",
    "message": "processing_error",
    "data": "CARD_TYPE_NOT_SUPPORTED"
  }
}

2. Проверьте статус транзакции

Возвращает статус транзакции A2C, выполненной transactionId.

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

GET {BASE_URL}/merchant/a2c/checkTransaction/{transactionId}/

Заголовки

Authorization: Bearer <ACCESS_TOKEN>

Параметры пути

Поле	Тип	Требуется	Описание
transactionId	string	Да	A2C транзакция ID, возвращенная performTransaction

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

{
  "status": "0",
  "statusText": "SUCCESS",
  "amountInTiyin": 2500000
}

Поле	Тип	Описание
status	string	Код статуса транзакции
statusText	string	Человекочитаемый статус транзакции
amountInTiyin	integer	Сумма перевода в тиыне

3. Проверка статуса транзакции с помощью внешнего ID

Возвращает статус транзакции A2C со стороны мерчанта externalId.

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

GET {BASE_URL}/merchant/a2c/checkTransaction/byExternalId/{externalId}/

Заголовки

Authorization: Bearer <ACCESS_TOKEN>

Параметры пути

Поле	Тип	Требуется	Описание
externalId	string	Да	Внешняя транзакция на стороне мерчанта ID отправлена ​​в performTransaction

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

{
  "status": "0",
  "statusText": "SUCCESS",
  "amountInTiyin": 2500000
}

4. Получить баланс счета

Возвращает баланс депозита торгового счета, доступный для переводов A2C.

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

GET {BASE_URL}/merchant/a2c/balance/

Заголовки

Authorization: Bearer <ACCESS_TOKEN>

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

{
  "balance": 50000
}

Поле	Тип	Описание
balance	integer	Доступный баланс в тиине

Формат баланса

50000 означает 500.00 UZS.

Статусы

В приведенных выше примерах для успешной транзакции используется status: "0". Видеть Статусы для общих кодов статуса Paylov.