API do Eleva Payments

{
  "success": true,
  "data": {
    "transaction_uuid": "9d3f1c1e-6a2b-4d7e-9a51-2f0c8b7e4a10",
    "amount": 49.90,
    "fee": 1.50,
    "amount_net": 48.40,
    "status": "pending",
    "qr_code": "00020101021226870014br.gov.bcb.pix2565...6304ABCD",
    "pix_code": "00020101021226870014br.gov.bcb.pix2565...6304ABCD",
    "qr_code_base64": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0i...",
    "expires_at": "2026-10-01T14:35:00-03:00",
    "expires_in_seconds": 300,
    "settlement": "brl"
  }
}

POST /seu-endpoint HTTP/1.1
Content-Type: application/json
User-Agent: Eleva Payments-Webhook/1.0
X-Webhook-Id: 1b4e28ba-2fa1-4d3b-a3f5-ef19b5a7633b
X-Webhook-Event: deposit.completed
X-Webhook-Timestamp: 1790871072
X-Webhook-Signature-V2: t=1790871072,v1=5f2b0c9e...a41
X-Webhook-Signature: 8c1d2e3f...9b0

{
  "id": "1b4e28ba-2fa1-4d3b-a3f5-ef19b5a7633b",
  "event": "deposit.completed",
  "data": {
    "transaction_uuid": "9d3f1c1e-6a2b-4d7e-9a51-2f0c8b7e4a10",
    "status": "completed",
    "type": "pix",
    "payment_method": "pix",
    "amount": 49.9,
    "amount_gross": 49.9,
    "amount_net": 48.4,
    "fee": 1.5,
    "settlement": "brl",
    "description": "Pedido #1042",
    "payer": { "name": "Maria Souza", "email": "[email protected]", "document": "52998224725" },
    "created_at": "2026-10-01T14:30:00-03:00",
    "paid_at": "2026-10-01T14:31:12-03:00"
  },
  "created_at": "2026-10-01T14:31:12-03:00"
}

<?php
// Cliente mínimo em PHP (cURL nativo). Guarde token e client id em variáveis de ambiente.
final class ElevaClient
{
    public function __construct(
        private string $token,
        private string $clientId,
        private string $baseUrl = 'https://app.elevapayments.live/api/v1',
    ) {}

    public function request(string $method, string $path, ?array $body = null): array
    {
        $ch = curl_init($this->baseUrl . $path);
        curl_setopt_array($ch, [
            CURLOPT_CUSTOMREQUEST  => $method,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 30,
            CURLOPT_HTTPHEADER     => [
                'Authorization: Bearer ' . $this->token,
                'X-Client-ID: ' . $this->clientId,
                'Content-Type: application/json',
                'Accept: application/json',
            ],
            CURLOPT_POSTFIELDS     => $body ? json_encode($body) : null,
        ]);
        $raw = curl_exec($ch);
        $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        $json = json_decode((string) $raw, true) ?? [];
        if ($status >= 400 && $status !== 402) {
            throw new RuntimeException($json['message'] ?? "Erro HTTP $status", $status);
        }
        return $json;
    }

    public function createPix(float $amount, string $name, string $email, string $cpf, string $description = ''): array
    {
        return $this->request('POST', '/payments/pix', [
            'amount' => round($amount, 2),
            'payer_name' => $name,
            'payer_email' => $email,
            'payer_cpf' => preg_replace('/\D/', '', $cpf),
            'description' => $description,
        ])['data'];
    }

    public function payment(string $uuid): array
    {
        return $this->request('GET', '/payments/' . $uuid)['data'];
    }
}

$eleva = new ElevaClient(getenv('ELEVA_API_TOKEN'), getenv('ELEVA_CLIENT_ID'));
$pix = $eleva->createPix(49.90, 'Maria Souza', '[email protected]', '529.982.247-25', 'Pedido #1042');
// Salve $pix['transaction_uuid'] junto do pedido e mostre $pix['qr_code_base64'] / $pix['pix_code'].

// Node.js 18+ (fetch nativo)
const BASE = 'https://app.elevapayments.live/api/v1';
const headers = {
  Authorization: `Bearer ${process.env.ELEVA_API_TOKEN}`,
  'X-Client-ID': process.env.ELEVA_CLIENT_ID,
  'Content-Type': 'application/json',
  Accept: 'application/json',
};

async function eleva(method, path, body) {
  const res = await fetch(BASE + path, { method, headers, body: body ? JSON.stringify(body) : undefined });
  const json = await res.json().catch(() => ({}));
  if (!res.ok && res.status !== 402) {
    const err = new Error(json.message || `HTTP ${res.status}`);
    err.status = res.status; err.errors = json.errors;
    throw err;
  }
  return json;
}

const { data: pix } = await eleva('POST', '/payments/pix', {
  amount: 49.90,
  payer_name: 'Maria Souza',
  payer_email: '[email protected]',
  payer_cpf: '52998224725',
  description: 'Pedido #1042',
});
console.log(pix.transaction_uuid, pix.pix_code);

const { data: status } = await eleva('GET', `/payments/${pix.transaction_uuid}`);
console.log(status.status); // pending | completed | cancelled ...

# Python 3 + requests
import os, requests

BASE = "https://app.elevapayments.live/api/v1"
session = requests.Session()
session.headers.update({
    "Authorization": f"Bearer {os.environ['ELEVA_API_TOKEN']}",
    "X-Client-ID": os.environ["ELEVA_CLIENT_ID"],
    "Accept": "application/json",
})

def eleva(method, path, **kwargs):
    r = session.request(method, BASE + path, timeout=30, **kwargs)
    data = r.json() if r.content else {}
    if r.status_code >= 400 and r.status_code != 402:
        raise RuntimeError(f"{r.status_code}: {data.get('message')} {data.get('errors', '')}")
    return data

pix = eleva("POST", "/payments/pix", json={
    "amount": 49.90,
    "payer_name": "Maria Souza",
    "payer_email": "[email protected]",
    "payer_cpf": "52998224725",
    "description": "Pedido #1042",
})["data"]
print(pix["transaction_uuid"], pix["pix_code"])

print(eleva("GET", f"/payments/{pix['transaction_uuid']}")["data"]["status"])