# TrustPay

> Gateway de pagamentos para o mercado brasileiro. Uma API para receber por
> cartão, PIX e boleto, cobrar por assinatura, dividir o valor entre
> subcontas (split), antecipar recebíveis e transferir o saldo.

- Base da API: `https://api.trustand.com.br/api/v1`
- Autenticação: header `X-API-Key`. Chave `gk_test_` opera em sandbox com os
  mesmos payloads da produção e sem tocar saldo real; `gk_live_` é produção.
- Valores em reais com até 2 casas (`149.90`); datas em ISO 8601 (UTC).
- Todo `POST` aceita o header `Idempotency-Key` (exceto as rotas `/auth/`).
  Envie um por cobrança: a retentativa com a mesma chave e o mesmo corpo
  devolve a resposta original em vez de cobrar o cliente de novo, e a mesma
  chave com corpo diferente responde 409.

## Documentação

- [Referência da API TrustPay](https://app.trustand.com.br/docs/referencia.md): Todas as rotas, parâmetros de filtro, formatos de erro e eventos de webhook.
- [Quickstart da integração](https://app.trustand.com.br/docs/quickstart.md): Da chave de teste à primeira cobrança aprovada, no menor caminho possível.
- [Guia: recebendo pagamentos](https://app.trustand.com.br/docs/guias/recebendo-pagamentos.md): Cartão, PIX e boleto ponta a ponta: criar a cobrança, confirmar e conciliar pelo webhook.
- [Guia: split e cashout](https://app.trustand.com.br/docs/guias/split-e-cashout.md): Dividir o valor entre subcontas e tirar o dinheiro da conta (saque e transferência).

## Schemas

- [OpenAPI](https://api.trustand.com.br/openapi.json): schema completo da API, gerado do
  código. Use para gerar cliente, montar requisição e validar payload.

## Opcional

- [Documentação completa](https://app.trustand.com.br/llms-full.txt): todos os documentos
  acima concatenados num arquivo só.
- [Portal da documentação](https://app.trustand.com.br/documentacao): a mesma referência em
  formato de portal, com exemplos de request e response lado a lado.