# VyvaPay — pacote de integração

Esta pasta existe para você **copiar inteira** para outro repositório ou enviar a uma IA ao integrar VyvaPay em um sistema externo.

## Conteúdo

| Arquivo | Uso |
|--------|-----|
| [`AI_INTEGRATION.md`](./AI_INTEGRATION.md) | Instruções estruturadas para modelo de IA (fluxos, endpoints, segurança, verificação). |

## Produção (referência)

- API: `https://server.vyvapay.com`
- Site merchant: `https://vyvapay.com`
- Prefixo API pública versionada: `/api/v1`

## Manutenção no repositório

Altere primeiro os arquivos em **`docs/`** e copie para **`public/docs/`** (mesmos nomes), para as URLs estáticas continuarem iguais.

## Web

Os mesmos arquivos ficam disponíveis como estático em:

- `https://vyvapay.com/docs/README.md`
- `https://vyvapay.com/docs/AI_INTEGRATION.md`

Índice no formato **llms.txt** (para assistentes e ferramentas que consomem esse padrão):

- `https://vyvapay.com/llms.txt`
- `https://vyvapay.com/.well-known/llms.txt`

A documentação interativa da API continua em **`https://vyvapay.com/docs`**.

## Fluxo rápido

1. Obter **API Key** (`sk_live_...`) no painel VyvaPay.
2. **Depósito (PIX):** `POST /api/v1/payments` → retorna PIX copia-e-cola / QR.
3. **Saque (PIX):** `POST /api/v1/withdrawals` com chave PIX e tipo.
4. **Webhooks:** registrar endpoint no painel; validar assinatura HMAC conforme `AI_INTEGRATION.md`. O provedor de pagamento envia eventos para a VyvaPay em `POST /api/webhooks/payment-gateway` (configuração interna da plataforma).

Detalhes, contratos e ordem exata das chamadas estão em **`AI_INTEGRATION.md`**.