Autenticação

Header obrigatório

Todas as requisições autenticadas devem incluir o token no header:

API-Key: SEU_TOKEN

Requisições sem esse header ou com token inválido retornam 401 Unauthorized.

Como obter um token

Acesse Configurações → Token no painel.

Formato do token

O token é um UUID v4. Exemplo:

550e8400-e29b-41d4-a716-446655440000

Boas práticas

Nunca exponha o token no frontend — guarde-o exclusivamente no backend
Não use em variáveis de ambiente prefixadas com NEXT_PUBLIC_ ou equivalentes de outros frameworks
O token é fixo e único por conta — para substituí-lo, solicite ao seu gerente de contas

Exemplos de uso

cURL

curl -X POST https://pix.evopay.cash/v1/pix \
  -H "API-Key: SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100.00}'

Node.js (Axios)

import axios from 'axios';

const client = axios.create({
  baseURL: 'https://pix.evopay.cash/v1',
  headers: {
    'API-Key': process.env.EVOPAY_TOKEN,
    'Content-Type': 'application/json',
  },
});

const { data } = await client.post('/pix', { amount: 100.00 });
console.log(data.id); // cmq47c6un0c05ufvvo58ohpqk

Python (requests)

import requests, os

BASE = 'https://pix.evopay.cash/v1'
HEADERS = {
    'API-Key': os.environ['EVOPAY_TOKEN'],
    'Content-Type': 'application/json',
}

r = requests.post(f'{BASE}/pix', json={'amount': 100.00}, headers=HEADERS)
print(r.json()['id'])  # cmq47c6un0c05ufvvo58ohpqk