Сплитование платежей

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

https://paysys.uz/gateway

Подготовка к онлайн оплате

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

Метод подготавливает платеж за заказанные товары, при этом необходимо указать список продавцов, которые должны получить оплату, и сумму средств для каждого из них.
После запроса метода, на телефон пользователя будет отправлен код подтверждения, которым пользователь подтвердит платеж.

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

vendor_form - Форма со списком продавцов
- account - Номер заказа в биллинг-системе торговой площадки
- total - Сумма платежа в тиинах
- vendors - Список брендов торговой площадки (обычно один, собственный)
  - id - Идентификатор торговой площадки в системе PaySys (vendor_id)
  - total - Сумма платежа в тиинах (общая сумма заказа)
  - subvendors - список продавцов-получателей и суммы платежей
    - id - Идентификатор продавца в системе PaySys (subvendor_id)
    - price - Сумма платежа для отдельного продавца
pay_form - Форма с данными покупателя
- card_number - Номер карты
- card_expire - Дата истечения срока действия карты. Формат даты MMYY

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

{
  "id": "d5d61968-7d41-4b17-9950-7d7b3f3c607b",
  "method": "marketplace.prepare_pay",
  "params": {
    "vendor_form": {
      "account": "8333",
      "total": "1810000",
      "vendors": [
        {
          "id": "101000",
          "total": "1810000",
          "subvendors": [
            {
              "id": "12",
              "price": "1460000"
            },
            {
              "id": "14",
              "price": "350000"
            }
          ]
        }
      ]
    },
    "pay_form": {
      "card_number": "8600330410689500",
      "card_expire": "0423"
    }
  }
}

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

masked_phone_number - Номер телефона, на который был отправлен СМС код для завершения платежа
time_out - Время жизни СМС кода для подтверждения операции
confirm_form - Поля формы, необходимые для метода подтверждения транзакции (описывает HTML элемент формы)
- label - Имя поля для пользователя
- key - Имя поля для отправки
- element - HTML тэг поля
- type - Тип валидации поля
- value - Значение поля
- show - Показывать ли элемент в форме
- mask - Маска заполнения элемента
- regex - Регулярное выражение для валидации ввода пользователя
- placeholder - Фраза внутри пустого элемента (подсказка)
- size - HTML атрибут - максимальная длинна ввода
- order - Сортировка элемента внутри формы
- is_required - Признак обязательности заполнения
request_method - Наименование следующего метода (куда нужно отправить форму)
mx_id - Трекер запроса

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

{
  "id": "d5d61968-7d41-4b17-9950-7d7b3f3c607b",
  "error": null,
  "result": {
    "masked_phone_number": "+99890*****11",
    "time_out": 300,
    "confirm_form": [
      {
        "label": "Код подтверждения",
        "key": "confirmation_code",
        "element": "input",
        "type": "int",
        "value": "",
        "show": 1,
        "mask": "######",
        "regex": "^[0-9]{6}$",
        "placeholder": "",
        "size": 6,
        "order": 10,
        "is_required": 1
      },
      {
        "key": "bank_transaction_id",
        "value": 97986541644,
        "show": 0,
        "is_required": 1
      }
    ],
    "request_method": "marketplace.confirm_pay"
  },
  "mx_id": "85b3465fdf351dabb540cd67e5e5423c"
}

Подтверждение онлайн оплаты

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

В случае передачи некорректного кода подтверждения или срок действия кода истек, метод вернет ошибку с кодом -32308.

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

confirm_form - Форма подтверждения платежа
- bank_transaction_id - Номер транзакции в системе PaySys
- confirmation_code - Код подтверждения платежа, полученный через СМС

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

{
  "id": "4d72c994-c97e-424f-8ff9-1d3e1d8b5004",
  "method": "marketplace.confirm_pay",
  "params": {
    "confirm_form": {
      "confirmation_code": "176941",
      "bank_transaction_id": "97986541644"
    }
  }
}

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

details - Объект с деталями проведенного платежа
- id - Промежуточный идентификатор запроса
- masked_card_number - Номер карты
- transaction_id - Идентификатор транзакции в системе PaySys
- bank_transaction_id - Номер транзакции в системе PaySys
- reference_number - Идентификатор транзакции процессингового центра
- amount - Сумма транзакции в тиинах
- merchantId - Идентификатор держателя торговой площадки в системе UZCARD ONLINE/HUMO
- terminalId - Идентификатор терминала в системе UZCARD ONLINE/HUMO
- date - Дата создания транзакции в секундах
mx_id - Трекер запроса

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

{
  "id": "4d72c994-c97e-424f-8ff9-1d3e1d8b5004",
  "error": null,
  "result": {
    "details": {
      "id": "1429072927",
      "masked_card_number": "860053******9500",
      "transaction_id": 2224168,
      "bank_transaction_id": 97986541644,
      "reference_number": "069878466747",
      "amount": 1810000,
      "merchantId": "900000000",
      "terminalId": "97000000",
      "date": 1602579976
    }
  },
  "mx_id": "d18e2de09789dd5f80f57d3ec4ac22e1"
}

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

Онлайн оплата с использованием идентификатора и токена карты

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

Перед использованием этого метода необходимо зарегистрировать карту пользователя.
При проведении платежа этим методом нет необходимости дополнительно его подтверждать по СМС. В заголовки запроса необходимо добавить заголовок токена карты.

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

vendor_form - Форма со списком продавцов
- account - Номер заказа в в биллинг-системе торговой площадки
- total - Сумма платежа в тиинах
- vendors - Список брендов торговой площадки (обычно один, собственный)
  - id - Идентификатор торговой площадки в системе PaySys (vendor_id)
  - total - Сумма платежа в тиинах (общая сумма заказа)
  - subvendors - список продавцов-получателей и суммы платежей
    - id - Идентификатор продавца в системе PaySys (subvendor_id)
    - price - Сумма платежа для отдельного продавца
pay_form - Форма с данными покупателя
- card_id - Идентификатор карты в системе PaySys

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

{
  "id": "d5d61968-7d41-4b17-9950-7d7b3f3c607b",
  "method": "marketplace.pay",
  "params": {
    "vendor_form": {
      "account": "8333",
      "total": "1810000",
      "vendors": [
        {
          "id": "101000",
          "total": "1810000",
          "subvendors": [
            {
              "id": "12",
              "price": "1460000"
            },
            {
              "id": "14",
              "price": "350000"
            }
          ]
        }
      ]
    },
    "pay_form": {
      "card_id": "6A0A002A1289688F2CDA1F1C0686359C16"
    }
  }
}

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

details - Объект с деталями проведенного платежа
- id - Промежуточный идентификатор запроса
- masked_card_number - Номер карты
- transaction_id - Идентификатор транзакции в системе PaySys
- bank_transaction_id - Номер транзакции в системе PaySys
- reference_number - Идентификатор транзакции процессингового центра
- amount - Сумма транзакции в тиинах
- merchantId - Идентификатор держателя торговой площадки в системе UZCARD ONLINE/HUMO
- terminalId - Идентификатор поставщика услуг в системе UZCARD ONLINE/HUMO
- date - Дата создания транзакции в секундах
mx_id - Трекер запроса

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

{
  "id": "d5d61968-7d41-4b17-9950-7d7b3f3c607b",
  "error": null,
  "result": {
    "details": {
      "id": 46894165546123,
      "masked_card_number": "860053******9500",
      "transaction_id": 2224168,
      "bank_transaction_id": 97986541644,
      "reference_number": "069878466747",
      "amount": 1810000,
      "merchantId": "900000000",
      "terminalId": "97000000",
      "date": 1602579976
    }
  },
  "mx_id": "85b3465fdf351dabb540cd67e5e5423c"
}

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

Сплитование платежей

Подготовка к онлайн оплате​

Подтверждение онлайн оплаты​

Онлайн оплата с использованием идентификатора и токена карты​

Подготовка к онлайн оплате

Подтверждение онлайн оплаты

Онлайн оплата с использованием идентификатора и токена карты