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

Настройка продавцов торговой площадки

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

https://paysys.uz/gateway

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

Добавление продавца торговой площадки в платежную систему​

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

Регистрирует нового продавца для торговой площадки в платежной системе PaySys.
Снятие комиссию за проведения платежа можно указать либо с продавца, либо с покупателя.

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

  • subvendor_id - Идентификатор продавца в биллинг-системе торговой площадки
  • vendor_id - Идентификатор держателя торговой площадки
  • org_account - Расчетный счет продавца
  • org_inn - ИНН продавца
  • org_mfo - МФО продавца
  • org_bank - Банк-эквайр продавца (не обязателен)
  • org_title - Название продавца
  • org_address - Юридический адрес продавца (не обязателен)
  • org_phone - Телефон продавца (не обязателен)
  • vendor_commission - комиссия, взимаемая с продавца, зарегистрированного на торговой площадке, в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
  • user_commission - комиссия, взимаемая с покупателя в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
Пример запроса
{
  "method": "marketplace.register_sub_vendor",
  "params": {
    "subvendor_id": 10,
    "vendor_id": 101494,
    "org_account": "20208033800590850000",
    "org_inn": "490080000",
    "org_mfo": "01100",
    "org_bank": "Bank name",
    "org_title": "OOО «TITLE MERCHANT»",
    "org_address": "STREET NAME",
    "org_phone": "998901234567",
    "vendor_commission": {
      "type": "procent",
      "commission": 2.3
    }
  },
  "id": "21cc03c9-9005-45fb-9cc6-b39d9e89ccd8"
}

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

  • agr_sub_vendor_id - Идентификатор продавца в системе PaySys
  • commission_payer - плательщик комиссии
    user - покупатель
    vendor - продавец
Пример ответа
{
  "error": null,
  "result": {
    "agr_sub_vendor_id": 148865,
    "commission_payer": "user"
  },
  "id": "21cc03c9-9005-45fb-9cc6-b39d9e89ccd8",
  "mx_id": "b94312ac5772e39389ba8c50c205ff33"
}

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

Подтверждение регистрации продавца для торговой площадки​

Платежная система PaySys отправляет запрос методом POST на URL адрес, предоставленный держателем торговой площадки, для сообщения об активации/деактивации продавца.
Для авторизации передается HTTP заголовок Auth, где его значением является хэш SHA1 от идентификатора платежного инструмента и его ключа: sha1(service_id + secret_key)

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

  • subvendor_id - Идентификатор продавца в биллинг-системе торговой площадки
  • status - Статус активности продавца в платежной системе PaySys
    0 - не активен
    1 - активен
Пример запроса
POST https://shop.merchant.uz/api/v1/subvendor_status
Content-Type: application/json
Accept: application/json
Content-Length: 32
Auth: 2bdcf37bb675a24da1ef381a9b62adf7265ba8e8

{"subvendor_id": 10,"status": 1}

Биллинг-система торговой площадки должна вернуть ответ с HTTP кодом 200 и пустым полем error. Если произошла ошибка, биллинг-система должна вернуть код ошибки неравный нулю и платежная система попробует еще раз отправить уведомление о смене статуса продавца (до 3-х раз).

Пример ответа
HTTP/1.1 200 OK
Content-Length: 31
Content-Type: application/json
Connection: Closed

{"error":null,"error_note": ""}

Изменние продавца торговой площадки в платежной системе​

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

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

  • subvendor_id - Идентификатор продавца в биллинг-системе торговой площадки
  • vendor_id - Идентификатор держателя торговой площадки

Параметры для обновления (не обязательны):

  • org_account - Расчетный счет продавца
  • org_inn - ИНН продавца
  • org_mfo - МФО продавца
  • org_bank - Банк-эквайр продавца
  • org_title - Название продавца
  • org_address - Юридический адрес продавца
  • org_phone - Телефон продавца
  • vendor_commission - комиссия, взимаемая с продавца, зарегистрированного на торговой площадке, в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
  • user_commission - комиссия, взимаемая с покупателя в пользу в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
Пример запроса
{
  "id": "806fe17c-25e3-4bc3-9c32-615d898d607d",
  "method": "marketplace.update_sub_vendor",
  "params": {
    "subvendor_id": 10,
    "vendor_id": 101494,
    "org_address": "CHANGED STREET NAME",
    "vendor_commission": {
      "type": "procent",
      "commission": 3.3
    }
  }
}

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

  • subvendor_id - Идентификатор продавца в биллинг-системе торговой площадки
  • vendor_id - Идентификатор держателя торговой площадки
  • org_account - Расчетный счет продавца
  • org_inn - ИНН продавца
  • org_mfo - МФО продавца
  • org_bank - Банк-эквайр продавца
  • org_title - Название продавца
  • org_address - Юридический адрес продавца
  • org_phone - Телефон продавца
  • vendor_commission - комиссия, взимаемая с продавца, зарегистрированного на торговой площадке, в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
  • user_commission - комиссия, взимаемая с покупателя в пользу в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
  • commission_payer - плательщик комиссии
    user - покупатель
    vendor - продавец
Пример ответа
{
  "error": null,
  "result": {
    "subvendor_id": 10,
    "vendor_id": 101494,
    "org_account": "20208033800590850000",
    "org_inn": "490080000",
    "org_mfo": "01100",
    "org_bank": "Bank name",
    "org_title": "OOО «TITLE MERCHANT»",
    "org_address": "CHANGED STREET NAME",
    "org_phone": "998901234567",
    "user_commission": {
      "type": "procent",
      "commission": 3.3
    },
    "commission_payer": "user"
  },
  "id": "806fe17c-25e3-4bc3-9c32-615d898d607d",
  "mx_id": "748369c6c736c3e0b2b3ca2ae0c7e891"
}

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

Получение списка зарегистрированных продавцов торговой площадки​

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

Возвращает список продавцов, зарегистрированных для торговой площадки. Параметры запроса могут быть пустыми и тогда вернет всех зарегистрированных продавцов для торговой площадки.

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

  • subvendor_id - Идентификатор продавца в биллинг-системе торговой площадки
  • vendor_id - Идентификатор держателя торговой площадки
  • status - Статус активности продавца в платежной системе PaySys
    0 - не активен
    1 - активен
Пример запроса
{
  "id": "2f378eae-d8d2-449f-938e-4e10bb5953ee",
  "method": "marketplace.sub_vendors_list"
}

Ответ содержит список сущностей-продавцов с атрибутами:

  • subvendor_id - Идентификатор продавца в биллинг-системе торговой площадки
  • vendor_id - Идентификатор держателя торговой площадки
  • org_account - Расчетный счет продавца
  • org_inn - ИНН продавца
  • org_mfo - МФО продавца
  • org_bank - Банк-эквайр продавца
  • org_title - Название продавца
  • org_address - Юридический адрес продавца
  • org_phone - Телефон продавца
  • vendor_commission - комиссия, взимаемая с продавца, зарегистрированного на торговой площадке, в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
  • user_commission - комиссия, взимаемая с покупателя в пользу в пользу торговой площадки при проведении оплаты
    • type - Тип комиссии
      procent - в процентах от общей суммы платежа
    • commission - Значение комиссии
Пример ответа
{
  "error": null,
  "result": [
    {
      "subvendor_id": 10,
      "vendor_id": 101494,
      "org_account": "20208033800590850000",
      "org_inn": "490080000",
      "org_mfo": "01100",
      "org_bank": "Bank name",
      "org_title": "OOО «TITLE MERCHANT»",
      "org_address": "CHANGED STREET NAME",
      "org_phone": "998901234567",
      "vendor_commission": {
        "type": "procent",
        "commission": 3.3
      }
    }
  ],
  "id": "2f378eae-d8d2-449f-938e-4e10bb5953ee",
  "mx_id": "6359fd852ec1b0b4aa1bf7c05406cbad"
}

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