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

Окончательный расчёт по товарам

URL шлюза оплаты

https://paysys.uz/gateway

До получения товара, деньги покупателя захолдированы и продавцы их еще не получили.

Подтверждение списания захолдированной суммы​

Название метода: marketplace.confirm_transfer
Авторизация: требуется

При вызове этого метода, средства пользователя, забронированные для оплаты товаров, будут переведены конечным получателям (продавцам) вместе с комиссией.

Запрос содержит:

Пример запроса
{
  "id": "3f79bf39-0a5f-45d0-a0f6-b00ae9c23046",
  "method": "marketplace.confirm_transfer",
  "params": {
    "transaction_id": "2224168",
    "org_account": "20208033800590850000",
    "org_mfo": "01100"
  }
}

Ответ содержит:

  • payment_number - Идентификатор транзакции перечисления денег продавцу
  • payment_status - Статус транзакции
    -1 - Ошибка. Обратитесь в службу поддержки PaySys
    1 - В ожидании на перевод. Будет автоматически проведена повторная попытка перевода
    2 - Успешно завершена
  • amount - Сумма, поступившая на счет продавца, в тиинах.
Пример ответа
{
  "id": "3f79bf39-0a5f-45d0-a0f6-b00ae9c23046",
  "error": null,
  "result": {
    "details": {
      "payment_number": "f90046713473982df67b7874c1ad0fa3",
      "payment_status": 2,
      "amount": "1629000"
    }
  }
}

В случае некорректных параметров запроса система вернет ошибку.

Отмена платежа​

Название метода: marketplace.reverse
Авторизация: требуется

Отмена платежа (reversal) невозможна, если время холдирования истекло или подтверждено списание захолдированной суммы.

Запрос содержит:

Пример запроса
{
  "id": "fa837be0-0b80-4290-b7e3-09d65143de1a",
  "method": "marketplace.reverse",
  "params": {
    "transaction_id": "2224168"
  }
}

Ответ содержит:

  • status - Статус транзакции
    -1 - Ошибка. Обратитесь в службу поддержки PSP
    0 - Создана
    2 - Успешно завершена
    3 - Отменена
Пример ответа
{
  "id": "fa837be0-0b80-4290-b7e3-09d65143de1a",
  "error": null,
  "result": {
    "status": 3
  }
}

В случае некорректных параметров запроса система вернет ошибку.

Получение списка переводов для платежа​

Название метода: marketplace.get_transaction
Авторизация: требуется

Проверяет статус платежа, и выдает список переводов средств на счета продавцов.

Запрос содержит:

Пример запроса
{
  "id": "1829d8e1-3474-48c0-bcee-a909476818ba",
  "method": "marketplace.get_transaction",
  "params": {
    "transaction_id": 2224168
  }
}

Ответ содержит:

  • id - Промежуточный идентификатор запроса
  • account - Номер заказа в биллинг-системе торговой площадки
  • status - Статус транзакции
    -1 - Ошибка. Обратитесь в службу поддержки PSP
    0 - Создана
    2 - Успешно завершена
    3 - Отменена
  • amount - Сумма транзакции в тиинах
  • date - Дата создания транзакции в секундах
  • transfers - Список переводов по транзакции
    • id - Идентификатор перевода
    • title - Название юридического лица
    • account - Расчетный счет получателя
    • amount - Сумма перевода в тиинах
    • stat - Статус перевода
      -1 - Ошибка. Обратитесь в службу поддержки PSP
      0 - Создан
      1 - В ожидании обработки
      2 - Успешно завершен
      3 - Платеж возвращен (refund)
      4 - В процессе выполнения
      5 - Захолдирован
    • created_at - Дата создания перевода в секундах
    • expired_at - Дата истечения холдирования перевода
  • mx_id - Трекер запроса
Пример ответа
{
  "id": "1829d8e1-3474-48c0-bcee-a909476818ba",
  "error": null,
  "result": {
    "id": 3375320,
    "account": "777777783",
    "status": 2,
    "amount": 900000,
    "date": 1647951794,
    "transfers": [
      {
        "id": 132,
        "title": "OOO MUSTANG-SAVDO",
        "account": "20207100604215482004",
        "amount": 846000,
        "stat": 4,
        "created_at": 1647951794,
        "expired_at": 1646742194
      }
    ]
  },
  "mx_id": "5f9d41e6bc6c2e2c9be4fe2e8e6e61a0"
}

В случае некорректных параметров запроса система вернет ошибку.

Возврат платежа​

Название метода: marketplace.refund
Авторизация: требуется

Сумма возврата средств зависит от издержек продавца/торговой площадки по процедуре возврата и обычно меньше суммы платежа.

Запрос содержит:

Пример запроса
{
  "id": "a6926622-d333-4181-99ea-16a0fd7620ae",
  "method": "marketplace.refund",
  "params": {
    "transaction_id": 3375414,
    "requisite_trans_id": 134,
    "partner_transaction_id": 11,
    "amount": 746000
  }
}

Ответ содержит:

  • id - Промежуточный идентификатор запроса
  • masked_card_number - Номер карты
  • transaction_id - Идентификатор транзакции в системе PaySys
  • bank_transaction_id - Номер транзакции в системе PaySys
  • ref_number - Идентификатор транзакции процессингового центра
  • merchantId - Идентификатор поставщика услуг в системе UZCARD ONLINE/HUMO
  • terminalId - Идентификатор терминала в системе UZCARD ONLINE/HUMO
  • amount - Сумма транзакции в тиинах
  • date - Дата создания транзакции в секундах
Пример ответа
{
  "error": null,
  "result": {
    "details": {
      "id": "1501097917",
      "masked_card_number": "860031******8295",
      "transaction_id": 41663832,
      "bank_transaction_id": "100009331",
      "ref_number": "014173418653",
      "merchantId": "90490020088",
      "terminalId": "91103031",
      "amount": 746000,
      "date": 1648211023
    }
  },
  "id": "a6926622-d333-4181-99ea-16a0fd7620ae",
  "mx_id": "62d2645817285f4126ee44edadfdfef7"
}