ABabacatepay

Criar subconta

Changed on

Cadastra um vendedor como subconta da sua loja, identificado pelo CPF ou CNPJ. Idempotente pelo taxId: se a subconta já existe, a API devolve a existente, com o saldo atual.

post/sub-accounts/create

Request

  • Base URL
    https://api.abacatepay.com/v2
  • URL
    https://api.abacatepay.com/v2/sub-accounts/create
  • Auth
    HTTP bearer

Request body

namestring required

Nome do titular.

taxIdstring required

CPF ou CNPJ do titular, com ou sem máscara.

externalIdstring

Identificador da subconta no seu sistema. Não pode se repetir entre as subcontas da loja.

metadataobject

Campos livres; todos os valores precisam ser texto.

Example request

{
  "name": "João da Silva",
  "taxId": "111.444.777-35",
  "externalId": "vendedor-42"
}

Response

Subconta criada, ou a existente com o mesmo taxId.

errorstring nullable
successboolean

Se a requisição obteve sucesso ou não.

Example response

{
  "data": {
    "id": "sacc_9f8Kq2LmX4vTzR7pWn3bYc1H",
    "name": "João da Silva",
    "taxId": "11144477735",
    "externalId": "vendedor-42",
    "balance": {
      "available": 7000
    },
    "metadata": {
      "loja": "centro"
    },
    "createdAt": "2026-10-26T14:22:10.381Z",
    "updatedAt": "2026-10-26T14:22:10.381Z"
  },
  "success": true
}

Changes