Skip to content

Sub Merchants

1. Sub Merchant Create API

Description:
Sub-merchant yaratish uchun API.
Agar merchant child merchant yaratmoqchi bo‘lsa, ushbu API ishlatiladi.

💡 Note: yaratilgan sub-merchant staff a’zolari tomonidan aktivlashtiriladi.

Endpoint details

Method: POST
URL: BASE_URL/merchant/sub-merchant/create/
Header:

http
Authorization: Bearer <ACCESS_TOKEN>

Request body

FieldTypeRequiredDescription
namestringYesSub-merchant nomi
tinstringOptionalIdentifikatsiya raqami. Agar yuborilsa, 9 xonali bo‘lishi kerak. INN
pinflstringOptionalJismoniy shaxsning PINFL ma’lumoti (JSHSHIR)
external_idstringYesTashqi identifikator

💡 Note: pinfl yoki tin yuborilishi kerak, lekin ikkalasi birga yuborilmasligi kerak.

Request example

json
{
  "name": "MrBeast",
  "tin": "123654987",
  "pinfl": "123456789012234",
  "external_id": "Someone External Id"
}

Response example

json
{
  "result": {
    "id": "c467b929-b850-40ae-9e38-fb2827684bda",
    "name": "MrBeast"
  }
}

Error response

💡 Note: TIN va PINFL faqat bir marta qabul qilinadi.

json
{
  "result": null,
  "error": {
    "code": "sub_merchant_already_created",
    "message": "Sub Merchant Already Created..."
  }
}