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

# SwytchPay API

> Gateway multi-provedor — PIX, SPEI, PSE e conversão para USDT

<Note>**Beta** — o contrato da 1.0 em evolução, ainda não em produção. Os campos podem mudar até o lançamento.</Note>

A API do **SwytchPay** integra **depósito, saque e conversão** num único gateway que orquestra múltiplos
provedores. Uma corretora pluga uma vez e opera em várias moedas, com redundância, roteamento e conciliação.

## Conceitos

* **Depósito** (`deposit`) — cobrança de entrada na moeda local (PIX, SPEI, PSE). A corretora cria, o
  pagador paga, o webhook confirma.
* **Saque** (`payout`) — saída para chave PIX, CLABE ou carteira USDT.
* **Conversão** (`conversion`) — troca o saldo de uma moeda por USDT, com taxa por par.
* **Saldo** (`balance`) — disponível / pendente / bloqueado, por moeda.
* **Webhook** — notificação assinada quando um recurso muda de status.
* **Modo test** — universo paralelo (chaves `pk_test_…`) para integrar sem dinheiro real.

## O que a 1.0 adiciona sobre a 0.1

* **`currency`** em depósito, saque e saldo — opere BRL, MXN, COP, ARS. Sem `currency`, o default é `BRL`.
* **`payment_method`** — o trilho: PIX, SPEI, OXXO, PSE, Nequi.
* **`charge`** polimórfico — cada método devolve o que o pagador precisa: o EMV no PIX, uma URL de
  redirecionamento nos trilhos LATAM, o endereço no cripto.
* **Conversão por par** — qualquer moeda para USDT, com taxa própria por par.
* **Cripto (USDT)** — depósito e saque de USDT direto na carteira (endereço + rede). Trilho em Beta.

## Princípios

* **Valor inteiro em centavos** — `amount`, nunca decimal. Sem ambiguidade de vírgula.
* **Idempotência** por `external_id` — repetir um POST devolve o recurso existente.
* **Webhook-first** — reaja ao webhook, não faça polling.

## Comece por aqui

<Card title="Quickstart" href="/v1.0/quickstart">Do zero ao depósito pago, em modo test.</Card>