API REST v1

Integração simples e poderosa

API RESTful completa para integrar pagamentos PIX em sua aplicação. Documentação clara, SDKs e suporte técnico dedicado.

Ver Documentação Testar no Sandbox

Comece em minutos

Crie uma cobrança PIX com apenas uma requisição

cURL

curl -X POST https://api.safesplit.com.br/v1/charges \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "description": "Pedido #12345",
    "customer": {
      "name": "João Silva",
      "document": "12345678900",
      "email": "joao@email.com"
    },
    "expires_in": 3600
  }'

Resposta

{
  "uuid": "chg_abc123def456",
  "amount": 15000,
  "status": "pending",
  "pix_key": "00020126580014br.gov.bcb.pix...",
  "qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
  "expires_at": "2025-01-15T12:00:00Z",
  "created_at": "2025-01-15T11:00:00Z"
}

Recursos da API

Tudo que você precisa para integrar

API completa com recursos avançados para qualquer cenário de integração.

QR Code Dinâmico

Gere QR Codes únicos para cada transação com valor pré-definido e identificação automática.

Webhooks em Tempo Real

Receba notificações instantâneas quando um pagamento é confirmado ou atualizado.

Autenticação Segura

API Keys com permissões granulares e autenticação via Bearer Token.

Estornos e Reembolsos

Processe estornos totais ou parciais diretamente pela API.

Relatórios Detalhados

Exporte transações, extratos e relatórios financeiros em múltiplos formatos.

Ambiente Sandbox

Teste todas as funcionalidades em ambiente isolado antes de ir para produção.

Endpoints

Principais endpoints

Explore os endpoints mais utilizados da nossa API.

Cobranças

POST /v1/charges

Criar uma nova cobrança PIX

GET /v1/charges/{uuid}

Consultar status de uma cobrança

GET /v1/charges

Listar todas as cobranças

Saques

POST /v1/payouts

Solicitar um saque do saldo disponível

GET /v1/payouts/{uuid}

Consultar status de um saque

Webhooks

POST /v1/webhooks

Registrar URL de webhook

DELETE /v1/webhooks/{uuid}

Remover webhook registrado

Ver Documentação Completa

SDKs

Bibliotecas oficiais

SDKs para as linguagens mais populares para acelerar sua integração.

🐘

PHP

composer require safesplit/php-sdk

🟨

JavaScript

npm install @safesplit/sdk

🐍

Python

pip install safesplit

💎

Ruby

gem install safesplit