Pagamentos API-first

Construa pagamentos sobre a REST API da Zedy Gateway.

Uma API pública, com escopo por tenant, para tokenizar cartões, criar charges, capturar pagamentos autorizados e receber webhooks assinados. Feita primeiro para devs, com contratos canônicos para pessoas, ferramentas e agentes de IA.

Explorar referencia da API OpenAPI 3.1 LLMs.txt

Base URL

Production

https://wl.zedy.com.br/api/v1

O que mudou

Pagamentos públicos são Charge-first. Não existem rotas públicas de PaymentIntent no pre-GA. Use POST /charges para cobrar ou autorizar, e POST /charges/:id/capture para capturar.

Quickstart

Fluxo de charge

Para cartões, tokeniza primeiro. Depois cria uma charge. Para captura manual, capture a charge autorizada quando o pedido estiver pronto.

1. Tokenizar cartão

curl -X POST https://wl.zedy.com.br/api/v1/payment-methods/tokenize \  -H "Authorization: Bearer sk_test_xxx" \  -H "Content-Type: application/json" \  -d '{    "card": {      "number": "4242 4242 4242 4242",      "exp_month": 12,      "exp_year": 2030,      "cvv": "123",      "holder_name": "Ada Lovelace"    }  }'

2. Autorizar charge

curl -X POST https://wl.zedy.com.br/api/v1/charges \  -H "Authorization: Bearer sk_test_xxx" \  -H "Idempotency-Key: order_123_charge" \  -H "Content-Type: application/json" \  -d '{    "amount": 10990,    "currency": "BRL",    "payment_method": "CREDIT_CARD",    "capture_method": "manual",    "card_token": "tok_xxx"  }'

3. Capturar depois

curl -X POST https://wl.zedy.com.br/api/v1/charges/ch_xxx/capture \  -H "Authorization: Bearer sk_test_xxx" \  -H "Idempotency-Key: order_123_capture"

Referência da API

Endpoints implementados

GET/health

Healthcheck

Retorna o envelope público de saúde da API.

POST/payment-methods/tokenize

Tokenizar método de pagamento

Troca dados sensíveis do cartão por um token `tok_`. Este é o único endpoint público que aceita PAN/CVV. Exige API key seller-scoped com KYC aprovado.

POST/charges