Criar subconta

POSThttps://{apiUrl}/subaccount

Atualizado em 28 de julho de 2025 · 2 min de leitura

Crie subcontas para realizar transações através do token de autenticação da subconta.

Endpoint: POST https://{apiUrl}/subaccount

Recurso específico para criação de subcontas por plataformas credenciadas pela Dom Pagamentos. Após a criação, a subconta receberá um token de autenticação para realizar transações.

📘 Status de criação da subconta:

Status Descrição
approved Cadastro foi aprovado e está apto para transacionar.
pending Cadastro pendente de análise
rejected Cadastro foi rejeitado pela análise de risco
blocked Cadastro bloqueado para operações
cancelled Cadastro cancelado

Status	Descrição
approved	Cadastro foi aprovado e está apto para transacionar.
pending	Cadastro pendente de análise
rejected	Cadastro foi rejeitado pela análise de risco
blocked	Cadastro bloqueado para operações
cancelled	Cadastro cancelado

CNPJ para teste de status em sandbox:

CNPJ	Status de retorno
21111111111111	pending
31111111111111	rejected

POSThttps://{apiUrl}/subaccount

URL base da API

Token de autenticação

curl --request POST \
  --url "https://{apiUrl}/subaccount" \
  --header "Content-Type: application/json" 
  --data '{}'

Response

Choose an example:

application/json

Exemplo de resposta

json

{
  "id": "subconta-uuid-aqui",
  "status": "pending",
  "token": "token-de-autenticacao-da-subconta",
  "created_at": "2024-10-01T15:36:00Z"
}

Campos da resposta

idstring

UUID único da subconta criada

statusstring

Estado: approved, pending, rejected, blocked ou cancelled

tokenstring

Token de autenticação da subconta — retornado apenas na criação

created_atstring

Data de criação no formato ISO 8601

O token é retornado apenas na criação. Nas consultas subsequentes ele não é mais exibido. Guarde-o com segurança.

Esta página foi útil?