Consultar Sub-conta

Consulta os dados e saldo de uma sub-conta.

GET /api/customer/

Endpoint

GET https://api.divipay.com.br/api/customer/{id}

Headers

Header	Valor	Obrigatório
Authorization	Bearer	Sim

Path Parameters

Parâmetro	Tipo	Descrição
id	string	ID da sub-conta

Exemplo de Requisição

cURL

curl -X GET https://api.divipay.com.br/api/customer/sub_abc123 \
  -H "Authorization: Bearer SEU_TOKEN"

JavaScript

const response = await fetch(
  'https://api.divipay.com.br/api/customer/sub_abc123',
  {
    headers: {
      'Authorization': 'Bearer SEU_TOKEN'
    }
  }
);

const customer = await response.json();

Resposta de Sucesso

Status: 200 OK

{
  "id": "sub_abc123",
  "name": "João Silva",
  "email": "joao@email.com",
  "document": "12345678901",
  "phone": "11999999999",
  "balance": 1500.00,
  "blockedBalance": 0.00,
  "status": 1,
  "taxes": [
    {
      "id": "tax_pix",
      "name": "Pix",
      "percent": 0.99
    }
  ]
}

Status da Sub-conta

Status	Descrição
0	Inativo
1	Ativo
2	Pendente
9	Excluído

Exemplo de Uso

async function getCustomerBalance(customerId) {
  const response = await fetch(
    `https://api.divipay.com.br/api/customer/${customerId}`,
    {
      headers: { 'Authorization': `Bearer ${token}` }
    }
  );

  const customer = await response.json();
  
  return {
    available: customer.balance - customer.blockedBalance,
    blocked: customer.blockedBalance,
    total: customer.balance
  };
}

Próximos Passos

• Atualizar Sub-conta
• Bloqueio de Saldo
• Saques