Выплаты на UzCard/HUMO
URL шлюза оплаты
https://paysys.uz/gateway
Подготовка выплаты
Название метода: cash2card.prepare_remittance
Авторизация: требуется
Запрос содержит:
- partner_transaction_id - Идентификатор платежа в системе партнера
- card_number - Номер карты получателя
- amount - Сумма выплаты в тиинах - минимум 100 000 тиин
- sender - Данные отправителя
- last_name - Фамилия отправителя
- first_name - Имя отправителя
- middle_name - Отчество отправителя (если есть)
- doc - Паспортные данные. Обязательный блок данных для выплат с лимитом от
50БРВ~ экв 1300$и выше, иначе можно не отправлять параметр- nationality - Гражданство, цифровой код страны ISO 3166-1
- type - Тип документа
passport- Паспорт - seriesNumber - Серия и номер документа
- birthDate - Дата рождения
- validTo - Срок действия документа
- mrz - ПИНФЛ (если есть)
Пример запроса
{
"method": "cash2card.prepare_remittance",
"params": {
"partner_transaction_id": 10181,
"card_number": "8600530410609500",
"amount": 400000,
"sender": {
"last_name": "Test",
"first_name": "Test",
"middle_name": ""
}
},
"id": "fcc851bd-1ed4-4586-8a8b-34044e5d8800"
}
Пример запроса от 50 БРВ
{
"method": "cash2card.prepare_remittance",
"params": {
"partner_transaction_id": 10182,
"card_number": "8600530410609500",
"amount": 1445000000,
"sender": {
"last_name": "Test",
"first_name": "Test",
"middle_name": ""
},
"doc": {
"nationality": "860",
"type": "passport",
"seriesNumber": "AA0000001",
"birthDate": "25.01.1990",
"validTo": "25.01.2025",
"mrz": "30101800050014"
}
},
"id": "fcc851bd-1ed4-4586-8a8b-34044e5d8800"
}
Ответ содержит:
- transaction_id - Идентификатор транзакции в системе PaySys
- partner_transaction_id - Идентификатор платежа в системе партнера
- masked_phone_number - Номер телефона отправителя, привязанный к карте
- recipient_card - Номер карты получателя
- recipient_name - Имя получателя
- amount - Сумма выплаты в тиинах
- commission - Комиссия за выплату в процентах
- total - Сумма списания с депозита отправителя в тиинах
Пример ответа
{
"id": "fcc851bd-1ed4-4586-8a8b-34044e5d8800",
"error": null,
"result": {
"transaction_id": 2354812,
"partner_transaction_id": 10181,
"masked_phone_number": "+99890*****50",
"recipient_card": "860031******2112",
"recipient_name": "TEST2 TEST2",
"amount": 400000,
"commission": 0.5,
"total": 402000
}
}
В случае некорректных параметров запроса система вернет ошибку.
Подтверждение выплаты
Название метода: cash2card.confirm_remittance
Авторизация: требуется
Запрос содержит:
- transaction_id - Идентификатор платежа в системе PaySys
Пример запроса
{
"method": "cash2card.confirm_remittance",
"params": {
"transaction_id": 2354812
},
"id": "0aea069d-66da-4af9-af53-c4157c354e2c"
}
Ответ содержит:
- transaction_id - Идентификатор платежа в системе PaySys
- status - Статус выплаты в системе PaySys
2- Выплата отменена1- Выплата завершена3- Отмена0- Выплата создана-1- Ошибка - date - Дата создания выплаты в секундах
Пример ответа
{
"id": "0aea069d-66da-4af9-af53-c4157c354e2c",
"error": null,
"result": {
"transaction_id": 2354812,
"status": 1,
"date": 1648988775
}
}
В случае некорректных параметров запроса система вернет ошибку.
Проверка статуса выплаты
Название метода: cash2card.check_remittance
Авторизация: требуется
Запрос содержит:
- partner_transaction_id - Идентификатор платежа в системе партнера
Пример запроса
{
"method": "cash2card.check_remittance",
"params": {
"partner_transaction_id": 10181
},
"id": "82a6dfe8-a8ed-40c7-8758-7c2d8f7b9073"
}
Ответ содержит:
- transaction_id - Идентификатор платежа в системе PaySys
- status - Статус выплаты в системе PaySys
2- Выплата отменена1- Выплата завершена0- Выплата создана-1- Ошибка - card_number - Номер карты получателя
- amount - Сумма выплаты в тиинах
Пример ответа
{
"id": "82a6dfe8-a8ed-40c7-8758-7c2d8f7b9073",
"error": null,
"result": {
"status": 1,
"transaction_id": 2354812,
"card_number": "860031******2112",
"amount": 400000
}
}
В случае некорректных параметров запроса система вернет ошибку.
Отмена выплаты
Название метода: cash2card.cancel
Авторизация: требуется
Запрос содержит:
- transaction_id - Идентификатор платежа в системе PaySys
Пример запроса
{
"method": "cash2card.cancel",
"params": {
"transaction_id": 2354812
},
"id": "92251a16-661c-4482-ac60-5222e4a27cb7"
}
Ответ содержит:
- result - Успешная отмена
Пример ответа
{
"id": "92251a16-661c-4482-ac60-5222e4a27cb7",
"error": null,
"result": true
}
В случае некорректных параметров запроса система вернет ошибку.
Сверка выплат
Название метода: cash2card.statement
Авторизация: требуется
Сверка необходима для выявления проблем при выполнении выплат. Рекомендуется проводить процедуру сверки ежедневно вне рабочих часов.
Запрос содержит:
- date_from - Дата начала интервала для сверки в секундах
- date_to - Дата окончания интервала для сверки в секундах
Пример запроса
{
"method": "cash2card.statement",
"params": {
"date_from": 1648926000,
"date_to": 1649012399
},
"id": "109ab538-b430-4e72-a75c-410cc482da4f"
}
Ответ содержит список деталей выплат, где:
- status - Статус выплаты в системе PaySys
2- Выплата отменена1- Выплата завершена0- Выплата создана-1- Ошибка - transaction_id - Идентификатор транзакции в системе PaySys
- partner_transaction_id - Идентификатор платежа в системе партнера
- recipient_card_number - Номер карты получателя
- recipient_name - Имя получателя
- amount - Сумма выплаты в тиинах
- commission_amount: - Сумма комиссии за выплаты в тиинах
- date - Дата создания выплаты в секундах
Пример ответа
{
"id": "109ab538-b430-4e72-a75c-410cc482da4f",
"error": null,
"result": [
{
"status": 1,
"transaction_id": 2354812,
"partner_transaction_id": 10181,
"recipient_card_number": "860031******2112",
"amount": 400000,
"commission_amount": 2000,
"date": 1648988775
}
]
}
В случае некорректных параметров запроса система вернет ошибку.