Sub Merchants

1. Sub Merchant Create API

Description:
API for creating a sub-merchant. If a merchant wants to create a child merchant, this API is used

💡 Note: the created sub-merchant is activated by staff members

Endpoint details

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

Authorization: Bearer <ACCESS_TOKEN>

Request body

Field	Type	Required	Description
name	string	Yes	Unique identifier for the transaction.
tin	string	Optional	Identification Number (must be 9 digits if provided). INN
pinfl	string	Optional	Individual’s PINFL (JSHSHIR)
external_id	string	Yes	Amount allocated to the recipient.

💡 Note: pinfl or tin must be provided, but not both

Request example

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

Response example

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

Error response

💡 Note: TIN and PINFL are accepted only once

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