API de Integração

Bem-vindo à documentação oficial da Verus Pro. Nossa API RESTful permite que você processe pagamentos via PIX, Cartão de Crédito e Criptomoedas de forma simples, segura e escalável.

Acessar Dashboard

Base URL

Todas as requisições devem ser enviadas para:

https://veruspro.com.br/api/v1

Autenticação

A API utiliza Bearer Token. Você deve enviar sua chave secreta (sk_live_...) no cabeçalho Authorization.

⚠️

Nunca exponha sua Chave Secreta no frontend (HTML/JS). Ela deve ser usada apenas no seu servidor (Backend).

Authorization: Bearer sk_live_Q80...

POST

/charges

Gera um código PIX Copia e Cola dinâmico para pagamento instantâneo.

Body (JSON)

{
  "amount_cents": 1500,
  "payment_method": "pix",
  "currency": "BRL"
}

Resposta (201 Created)

{
  "id": "f3ddcc22-7276-450d-8ee5-7a6d0ba9c872",
  "status": "waiting_payment",
  "amount_cents": 1500,
  "payment_method": "pix",
  "pix": {
    "qr_code": "00020126580014BR.GOV.BCB.PIX...",
    "expiration": "2025-12-06T00:00:00"
  },
  "created_at": "2025-12-04T14:30:53"
}

POST

/charges (Cartão)

Processa pagamentos via Cartão de Crédito.
Por segurança, você deve enviar o card_token gerado pelo frontend (Stripe.js), nunca os dados puros do cartão.

Body (JSON)

{
  "amount_cents": 4990,
  "payment_method": "credit_card",
  "card_token": "tok_1N3...", 
  "installments": 1,
  "currency": "BRL"
}

Resposta (201 Created)

{
  "id": "a1b2c3d4...",
  "status": "authorized",
  "amount_cents": 4990,
  "card": {
    "brand": "Visa",
    "last4": "4242"
  }
}

POST

/charges (Cripto)

Gera um endereço de carteira temporário para recebimento em USDT.

Body (JSON)

{
  "amount_cents": 10000,
  "payment_method": "crypto",
  "currency": "BRL"
}

Resposta (201 Created)

{
  "id": "e5f6g7h8...",
  "status": "waiting_payment",
  "crypto": {
    "wallet_address": "0x71C...",
    "amount_to_pay": "20.00 USDT"
  }
}

Webhooks

Configure uma URL de Notificação no seu Dashboard para receber atualizações de status automáticas. Sempre que um pagamento mudar de status (ex: paid ou failed), enviaremos um POST para você.

Payload do Evento

{
  "event": "transaction.paid",
  "data": {
    "id": "f3ddcc22-7276-450d-8ee5-7a6d0ba9c872",
    "status": "paid",
    "amount_cents": 1500,
    "updated_at": "2025-12-04T14:31:15"
  }
}