> ## Documentation Index
> Fetch the complete documentation index at: https://dev.valorapayments.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Valora Payments API (Brazil: Pix, card, boleto). Base URL https://api.valorapayments.com.br, Authorization: Bearer sk_vl_... used only on the server. Request amounts are reais as strings ("149.90"); response amounts are integer cents (14990). Use POST /v1/checkouts for card and boleto; POST /v1/payments only creates Pix and should send an Idempotency-Key. Confirm payments only through the payment.succeeded webhook after verifying X-Valora-Signature (hex HMAC-SHA256 of "<t>.<raw body>"), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json.

# Skill para agentes

> Instale a skill da Valora no seu agente de código para ele saber integrar e revisar pagamentos sem você repetir as regras.

A skill é um pacote de instruções que o agente carrega sozinho quando a tarefa envolve a Valora. Ela traz as regras de segurança, o formato do dinheiro, a escolha entre checkout e Pix e a verificação do webhook, além dos links para as páginas certas.

## Instalar

```bash theme={null}
npx skills add https://dev.valorapayments.com.br
```

O comando detecta os agentes instalados (Claude Code, Cursor, Codex e outros) e instala a skill em cada um.

## Quando o agente usa

A skill entra automaticamente quando você pede algo como:

* "Integre a Valora neste projeto."
* "Crie o endpoint de webhook da Valora."
* "Adicione Pix com a Valora na tela de pagamento."
* "Revise o código de pagamentos."

## O que ela ensina

| Tema | Regra principal |
| - | - |
| Segurança | chave e segredo só no servidor, em variáveis de ambiente |
| Dinheiro | reais como texto na entrada, centavos inteiros na saída |
| Fluxo | checkout para Pix, cartão e boleto; `POST /v1/payments` só para Pix |
| Confirmação | pedido pago só com `payment.succeeded` e assinatura válida |
| Webhook | corpo cru, HMAC-SHA256, tempo constante, eventos repetidos ignorados |
| Revisão | checklist de seis pontos antes de produção |

> [!NOTE]
>
> A skill complementa o [servidor MCP](https://dev.valorapayments.com.br/ia/mcp.md): a skill diz **como** integrar, e o MCP traz os **detalhes** de cada página quando o agente precisa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.