Consultar subconta

Uma subconta com o saldo atribuído atual, o e-mail, o metadata e a chave Pix do cliente.

GET /v1/subaccounts/{id}

cURL

curl https://bukio-backend-production.up.railway.app/v1/subaccounts/vendedor-42 \
  -H "Authorization: Bearer bk_live_..."

200

{
  "id": "sacc_9f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
  "name": "Ateliê da Ana",
  "externalId": "vendedor-42",
  "hasEmail": true,
  "email": "[e-mail]",
  "saleFee": { "percentBps": 500, "fixed": 0 },
  "withdrawFee": { "percentBps": 0, "fixed": 200 },
  "balance": 14200,
  "active": true,
  "document": "123.456.789-00",
  "pixKey": { "keyType": "cpf", "key": "123.456.789-00", "holderName": "Ana S.", "institution": "Banco Exemplo" },
  "metadata": { "plano": "pro" },
  "createdAt": "2026-10-08T15:00:00.000Z"
}

Escopo transactions:read. Excluída ou de outra conta: 404 NOT_FOUND.

id · string · required

sacc_ + 32 hex ou o seu externalId.

​

Resposta

O formato de Criar subconta: os campos da lista com o email, o document (CPF ou CNPJ do titular) e a chave Pix do cliente (pixKey.key) inteiros, mais o metadata. Na lista, o document e a chave vêm mascarados.

cURL

curl https://bukio-backend-production.up.railway.app/v1/subaccounts/vendedor-42 \
  -H "Authorization: Bearer bk_live_..."

200

{
  "id": "sacc_9f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
  "name": "Ateliê da Ana",
  "externalId": "vendedor-42",
  "hasEmail": true,
  "email": "[e-mail]",
  "saleFee": { "percentBps": 500, "fixed": 0 },
  "withdrawFee": { "percentBps": 0, "fixed": 200 },
  "balance": 14200,
  "active": true,
  "document": "123.456.789-00",
  "pixKey": { "keyType": "cpf", "key": "123.456.789-00", "holderName": "Ana S.", "institution": "Banco Exemplo" },
  "metadata": { "plano": "pro" },
  "createdAt": "2026-10-08T15:00:00.000Z"
}