Serviços para a sua aplicação

CLAUDO Pay e Billing

Cobranças e assinaturas do seu SaaS, na sua conta Asaas, Stripe ou Mercado Pago.

Conectar a sua conta

Em Pay, escolha o provedor e cole a chave da sua conta (Asaas: chave da API, com Teste ou Produção; Stripe: chave secreta; Mercado Pago: Access Token), e Conferir e conectar. O dinheiro vai direto para a sua conta: a CLAUDO não passa pelo pagamento.

Asaas: o painel mostra uma URL de webhook e um token, para cadastrar em Integrações → Webhooks no Asaas.
Stripe: o webhook é criado sozinho.
Mercado Pago: cadastre a URL de webhook mostrada para assinaturas; a assinatura secreta é opcional.

Chave da API

Em Chaves da API, crie uma chave claudo_pay_... e grave como variável do projeto (por exemplo CLAUDO_PAY_KEY). A API fica em https://claudo.com.br/api/pay/v1, com Authorization: Bearer <chave>. Só no servidor.

curl -X POST https://claudo.com.br/api/pay/v1/charges \
  -H "Authorization: Bearer $CLAUDO_PAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": { "name": "Ana", "document": "12345678909", "email": "ana@exemplo.com" },
    "amount_cents": 4990,
    "due_date": "2026-11-10",
    "description": "Plano Pro"
  }'

A resposta traz invoice_url: mande esse link para quem paga, que escolhe Pix, boleto ou cartão na página do provedor. Valor de R$ 5,00 a R$ 100.000,00.

O que a API faz

Chamada	Para quê
`POST /charges`	cobrança avulsa; `split` divide o valor (só Asaas)
`GET /charges/<id>`, `DELETE /charges/<id>`	consultar; cancelar pendente ou vencida
`POST /charges/<id>/refund`	devolver tudo ou `amount_cents` de uma paga
`GET /plans`	planos criados no painel, em Planos do seu SaaS
`POST /subscriptions`	assinar um plano: `plan_id`, `customer`
`PATCH /subscriptions/<id>`	trocar de plano; `proration: "charge"` cobra a diferença proporcional
`DELETE /subscriptions/<id>`	cancelar
`POST /subscriptions/<id>/usage`	registrar uso, para plano com cobrança por uso
`POST /portal`	link de uma hora para o assinante ver cobranças e, se permitido, cancelar

No Mercado Pago, a assinatura nasce pendente e quem paga autoriza pelo checkout_url. Os eventos payment.* e subscription.* chegam pelos webhooks.