X-Client-Id: seu_client_id
X-Client-Secret: seu_client_secret
Content-Type: application/json
Accept: application/json

{
    "amount": 15000,
    "description": "Pedido #12345 - Loja Virtual",
    "external_id": "order_12345",
    "expires_in": 30,
    "customer": {
        "name": "João da Silva",
        "email": "joao@email.com",
        "document": "12345678900"
    },
    "metadata": {
        "order_id": "12345",
        "product": "Camiseta Azul"
    }
}

{
    "success": true,
    "data": {
        "uuid": "chg_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "amount": 15000,
        "amount_formatted": "R$ 150,00",
        "status": "pending",
        "description": "Pedido #12345 - Loja Virtual",
        "external_id": "order_12345",
        "pix_key": "00020126580014br.gov.bcb.pix...",
        "pix_qrcode": "data:image/png;base64,iVBORw0KGgo...",
        "pix_qrcode_url": "https://api.safesplit.com.br/qr/chg_a1b2c3d4...",
        "expires_at": "2026-01-15T15:30:00.000Z",
        "created_at": "2026-01-15T15:00:00.000Z"
    }
}

<img src="{{ $charge->pix_qrcode }}" alt="QR Code PIX" />

<!-- Ou usando a URL direta -->
<img src="{{ $charge->pix_qrcode_url }}" alt="QR Code PIX" />

{
    "success": true,
    "data": {
        "uuid": "chg_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "amount": 15000,
        "status": "paid",
        "paid_at": "2026-01-15T15:05:32.000Z",
        "payer": {
            "name": "João da Silva",
            "document": "***456789**"
        }
    }
}

curl -X GET "https://api.safesplit.com.br/api/v1/charges?status=paid&start_date=2026-01-01&per_page=50" \
  -H "X-Client-Id: seu_client_id" \
  -H "X-Client-Secret: seu_client_secret"

{
    "success": true,
    "message": "Cobrança cancelada com sucesso",
    "data": {
        "uuid": "chg_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "status": "cancelled",
        "cancelled_at": "2026-01-15T15:10:00.000Z"
    }
}

{
    "event": "charge.paid",
    "timestamp": "2026-01-15T15:05:32.000Z",
    "data": {
        "uuid": "chg_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "amount": 15000,
        "status": "paid",
        "external_id": "order_12345",
        "paid_at": "2026-01-15T15:05:32.000Z",
        "payer": {
            "name": "João da Silva",
            "document": "***456789**"
        }
    }
}

Content-Type: application/json
X-Webhook-Signature: sha256=a1b2c3d4e5f6...
X-Webhook-Timestamp: 1705330532
X-Webhook-Id: whk_a1b2c3d4e5f6

{
    "amount": 50000,
    "pix_key_type": "cpf",
    "pix_key": "12345678900",
    "description": "Pagamento de comissão",
    "external_id": "commission_001"
}

{
    "success": true,
    "data": {
        "uuid": "pay_x9y8z7w6-v5u4-t3s2-r1q0-p9o8n7m6l5k4",
        "amount": 50000,
        "amount_formatted": "R$ 500,00",
        "status": "processing",
        "pix_key_type": "cpf",
        "pix_key": "***456789**",
        "description": "Pagamento de comissão",
        "external_id": "commission_001",
        "created_at": "2026-01-15T15:00:00.000Z"
    }
}

{
    "success": true,
    "data": {
        "uuid": "pay_x9y8z7w6-v5u4-t3s2-r1q0-p9o8n7m6l5k4",
        "amount": 50000,
        "status": "completed",
        "pix_key_type": "cpf",
        "pix_key": "***456789**",
        "recipient": {
            "name": "Maria Santos",
            "bank": "Banco do Brasil"
        },
        "completed_at": "2026-01-15T15:00:05.000Z",
        "end_to_end_id": "E12345678202601151500..."
    }
}

{
    "success": false,
    "error": {
        "code": "validation_error",
        "message": "Os dados fornecidos são inválidos",
        "details": {
            "amount": ["O campo amount é obrigatório"],
            "description": ["O campo description deve ter no máximo 255 caracteres"]
        }
    }
}

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1705330600

<?php

use SafeSplit\SafeSplit;
use SafeSplit\Exceptions\SafeSplitException;

// Inicializar o cliente
$safesplit = new SafeSplit([
    'client_id' => 'seu_client_id',
    'client_secret' => 'seu_client_secret',
    'environment' => 'sandbox' // ou 'production'
]);

// Criar uma cobrança
try {
    $charge = $safesplit->charges->create([
        'amount' => 15000, // R$ 150,00
        'description' => 'Pedido #12345',
        'external_id' => 'order_12345',
        'customer' => [
            'name' => 'João da Silva',
            'email' => 'joao@email.com',
            'document' => '12345678900'
        ]
    ]);
    
    echo "QR Code: " . $charge->pix_qrcode;
    echo "Código PIX: " . $charge->pix_key;
    
} catch (SafeSplitException $e) {
    echo "Erro: " . $e->getMessage();
}

// Consultar cobrança
$charge = $safesplit->charges->find('chg_a1b2c3d4...');
echo "Status: " . $charge->status;

// Criar payout
$payout = $safesplit->payouts->create([
    'amount' => 50000,
    'pix_key_type' => 'cpf',
    'pix_key' => '12345678900'
]);

const { SafeSplit } = require('@safesplit/sdk');

// Inicializar o cliente
const safesplit = new SafeSplit({
    clientId: 'seu_client_id',
    clientSecret: 'seu_client_secret',
    environment: 'sandbox' // ou 'production'
});

// Criar uma cobrança
async function createCharge() {
    try {
        const charge = await safesplit.charges.create({
            amount: 15000, // R$ 150,00
            description: 'Pedido #12345',
            externalId: 'order_12345',
            customer: {
                name: 'João da Silva',
                email: 'joao@email.com',
                document: '12345678900'
            }
        });
        
        console.log('QR Code:', charge.pixQrcode);
        console.log('Código PIX:', charge.pixKey);
        
        return charge;
    } catch (error) {
        console.error('Erro:', error.message);
    }
}

// Webhook handler (Express)
app.post('/webhook', safesplit.webhooks.verify('seu_webhook_secret'), (req, res) => {
    const event = req.body;
    
    switch (event.event) {
        case 'charge.paid':
            console.log('Pagamento recebido:', event.data.uuid);
            break;
    }
    
    res.json({ received: true });
});