Documentação Verdin
Pagamentos PIX e cartões que os devs amam.
Uma API REST simples, respostas em snake_case previsíveis e webhooks assinados. Crie sua primeira cobrança em menos de cinco minutos.
O que é a Verdin
A Verdin é uma plataforma brasileira de pagamentos: você cria cobranças PIX, compartilha links de pagamento e emite cartões virtuais — tudo por uma API única, com repasse na sua conta e notificação a cada venda. Cada pagamento recebido é um passarinho verde cantando boa notícia.
Como funciona o fluxo
Uma venda por PIX segue sempre o mesmo caminho:
- Crie a cobrança com
POST /api/v1/charges— você recebe obrcode(copia-e-cola) e a URL do QR Code. - Mostre ao pagador o QR Code / código copia-e-cola, ou redirecione para a
payment_urlhospedada pela Verdin. - Receba o webhook
charge.paidassim que o PIX cair — atualize seu sistema e libere o produto.
Início rápido
Com sua chave em mãos, este comando cria uma cobrança de R$ 49,90 (o campo amount é sempre em centavos):
cURL
curl https://api.verdin.com.br/api/v1/charges \
-H "Authorization: Bearer vrd_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 4990,
"description": "Plano Pro — mensal",
"customer": { "name": "Ana Souza", "email": "ana@exemplo.com" }
}'Base URL de produção:
https://api.verdin.com.br. Em desenvolvimento local, use http://localhost:3900. Todos os exemplos desta documentação funcionam nas duas.Explore a documentação
AutenticaçãoGere sua chave vrd_live_ e autentique com Bearer.Cobranças PIXCrie uma cobrança e receba o BR Code para o pagador.Links de pagamentoCompartilhe um link e venda sem escrever código.Cartões virtuaisEmita cartões que debitam o seu saldo Verdin.WebhooksSeja avisado em tempo real quando uma cobrança é paga.Referência da APITodos os endpoints, campos e respostas num só lugar.
Quer testar sem mover dinheiro de verdade? Leia Sandbox e testes e simule pagamentos e compras no cartão localmente.