Consultar Saldo

Retorna os dados de saldo da conta autenticada ou de uma sub-conta.

GET /api/me

Endpoint

GET https://api.divipay.com.br/api/me

Headers

Header	Valor	Obrigatório
Authorization	Bearer	Sim

Query Parameters

Campo	Tipo	Descrição	Obrigatório
customerId	string	Id da sub-conta. Se não informado, retorna dados da conta principal	Não

Exemplo de Requisição

cURL

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

JavaScript

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

const data = await response.json();
console.log('Saldo:', data.balance);

Python

import requests

response = requests.get(
    'https://api.divipay.com.br/api/me',
    headers={
        'Authorization': 'Bearer SEU_TOKEN'
    }
)

data = response.json()
print(f"Saldo: {data['balance']}")

PHP

<?php
$ch = curl_init('https://api.divipay.com.br/api/me');

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SEU_TOKEN'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

echo 'Saldo: ' . $data['balance'];
?>

Consultar Sub-conta

curl -X GET "https://api.divipay.com.br/api/me?customerId=5a4c2b18-8f01-49cc-9e3d-2b3b7f1d4e66" \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta de Sucesso

Status: 200 OK

{
  "id": "5a4c2b18-8f01-49cc-9e3d-2b3b7f1d4e66",
  "name": "Empresa Exemplo LTDA",
  "balance": 15000.50,
  "balanceBlocked": 500.00,
  "balanceLocked": 0.00
}

Campo	Tipo	Descrição
id	string	Id da conta
name	string	Nome da conta
balance	number	Saldo disponível
balanceBlocked	number	Saldo bloqueado (pendente)
balanceLocked	number	Saldo travado

Respostas de Erro

401 Unauthorized

Token inválido ou expirado.

404 Not Found

Conta não encontrada.

{
  "statusCode": 404,
  "message": "Customer not found"
}