Добавить организацию

POST

/v1/portal/orgs

curl --request POST \
  --url https://api.rekassa.uz/v1/portal/orgs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "kind": "legal", "tin": "example", "clientId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "address": "example", "directorName": "example", "phone": "example", "bankName": "example", "bankMfo": "example", "bankAccount": "example" }'

• Production
• Local

Сотрудник reKassa добавляет ЮЛ (обычно после автозаполнения по ИНН). Создаётся новый клиент; добавивший становится его Владельцем, пока аккаунт не передан клиенту. Статус — «Требуется договор».

Authorizations

• bearer

Request Body^required

Media typeapplication/json

object

kind

required

string

Allowed values: legal individual

tin

required

string

/^\d{9}$|^\d{14}$/

clientId

Add to an existing client; omit to create a new one

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

name

required

string

>= 1 characters <= 300 characters

address

string

>= 1 characters <= 500 characters

directorName

string

>= 1 characters <= 200 characters

phone

string

bankName

string

>= 1 characters <= 200 characters

bankMfo

string

/^\d{5}$/

bankAccount

string

/^\d{20}$/

Responses

201

Media typeapplication/json

object

id

required

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

clientId

required

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

kind

required

string

Allowed values: legal individual

tin

required

string

name

required

string

address

required

string

nullable

directorName

required

string

nullable

phone

required

string

nullable

bankName

required

string

nullable

bankMfo

required

string

nullable

bankAccount

required

string

nullable

verificationStatus

required

string

Allowed values: not_started pending verified needs_action rejected

contractStatus

required

«Требуется договор» / «Договор на подписании» / «Договор заключён» — по договорам в Didox

string

Allowed values: contract_required contract_in_progress contract_signed

verificationNote

required

string

nullable

submittedAt

required

string format: date-time

nullable /^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$/

verifiedAt

required

string format: date-time

nullable /^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$/

createdAt

required

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$/

Example

{
  "kind": "legal",
  "verificationStatus": "not_started",
  "contractStatus": "contract_required"
}

400

Request is malformed (validation_failed)

Media typeapplication/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Localized by Accept-Language

string

details

object

key

additional properties

requestId

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

401

Not authenticated

Media typeapplication/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Localized by Accept-Language

string

details

object

key

additional properties

requestId

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

403

Not allowed

Media typeapplication/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Localized by Accept-Language

string

details

object

key

additional properties

requestId

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

404

Not found

Media typeapplication/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Localized by Accept-Language

string

details

object

key

additional properties

requestId

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

409

Conflicts with the current state

Media typeapplication/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Localized by Accept-Language

string

details

object

key

additional properties

requestId

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}