> ## Documentation Index
> Fetch the complete documentation index at: https://paysure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> API REST da Paysure para pagamentos PIX

Bem-vindo à documentação da **Paysure API** — a forma mais simples de integrar PIX no seu produto.

## O que a Paysure faz

* **Recebe pagamentos PIX** (cash-in) via QR Code dinâmico gerado por API.
* **Envia pagamentos PIX** (cash-out) para chaves DICT (CPF, CNPJ, email, phone, EVP).
* **Distribui splits** automaticamente — divida cada transação entre múltiplos destinatários (% configurável).
* **Notifica via webhook** todo evento relevante (`paid`, `refunded`, etc) na URL que você fornece.

## Conceitos-chave

<CardGroup cols={2}>
  <Card title="Valores em centavos" icon="coin">
    Toda quantia é em **centavos** (`value_cents`). R$ 1,00 = 100. R$ 99,90 = 9990.
  </Card>

  <Card title="external_id é seu ID" icon="fingerprint">
    Sempre envie um `external_id` único por transação. Garante idempotência se a request for repetida.
  </Card>

  <Card title="Webhooks são a verdade" icon="bell">
    A resposta HTTP 201 só diz que a transação foi *aceita*. O status final (`paid`/`refunded`) chega via webhook.
  </Card>

  <Card title="Splits em %" icon="chart-pie">
    Splits são definidos em percentual do valor bruto (`{value: 5}` = 5%).
  </Card>
</CardGroup>

## Próximo passo

<CardGroup cols={2}>
  <Card title="Implementar com I.A" icon="robot" href="/implementar-com-ia">
    Baixe a doc otimizada e cole no Claude/ChatGPT/Cursor — o agente integra a Paysure sozinho.
  </Card>

  <Card title="Quickstart manual" icon="rocket" href="/quickstart">
    Faça sua primeira cobrança PIX em 5 minutos, passo a passo.
  </Card>
</CardGroup>
