baynoy

API & SDK

Uma API feita para desenvolvedores

Uma API REST com OpenAPI 3.1, chaves de idempotência, paginação por cursor e SDKs em JavaScript, Python, PHP, Ruby, Go e C#.

Obter chaves API Ler a documentação
Desenvolvedor trabalhando com a API Baynoy

<150ms

Latência API P50

99.95%

SLA de uptime

6

SDKs oficiais

  • Spec OpenAPI 3.1
  • Chaves de idempotência
  • Paginação por cursor
  • Autenticação Bearer
  • Webhooks HMAC
  • Sandbox + cartões de teste
  • 6 SDKs oficiais
  • Limite 1.000 req/sec
  • SLA de uptime 99,95%

Criar uma cobrança

Um endpoint, trinta métodos

Faça um POST em um único recurso e o Baynoy cuida do resto — cartão, Apple Pay, Google Pay. Defina a moeda de destino e nós encaminhamos o repasse para o seu banco ou wallet na liquidação.

  • Idempotency-Key evita cobranças duplicadas no retry
  • Paginação por cursor para relatórios de grande volume
  • Challenge 3DS inline via checkout_url
  • Chaves sandbox nunca tocam dinheiro real

Requisição

POST /v1/payments
Authorization: Bearer sk_live_••••
Idempotency-Key: 7a1f2e

{
  "amount": 125000,
  "currency": "EUR",
  "payout":  { "type": "bank", "currency": "TRY" },
  "methods": ["card","usdc","sepa"],
  "metadata": { "patient_id": "p_8821" }
}

Resposta

{
  "id": "pmt_a7c91...",
  "status": "requires_action",
  "checkout_url": "https://pay.baynoy.com/c/a7c91"
}

Início rápido

# No SDK to install — it's a plain REST API.
# Create a payment link from any HTTP client:
curl https://baynoy.com/api/v1/payment-links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Invoice 0042","amount":2000,"currency":"USD"}'

API REST

Chame de qualquer linguagem

Uma API REST simples com autenticação Bearer — sem SDK para instalar. Chame com curl, fetch, requests ou qualquer cliente HTTP. Pronta para produção: respostas versionadas, retries idempotentes, webhooks assinados e paginação por cursor.

  • Respostas estáveis e versionadas via cabeçalho Baynoy-Version
  • Idempotency-Key em cada POST — um retry nunca cobra em duplicado
  • Webhooks assinados com HMAC-SHA256 (t=…,v1=…)
  • Paginação por cursor em cada endpoint de listagem
Ler a documentação

Webhooks

Eventos em que você pode confiar

Cada webhook é assinado com HMAC SHA-256, reentregue com backoff exponencial por até 7 dias e navegável no seu dashboard com histórico completo de request / response. Reproduza qualquer evento passado com um clique.

  • Payloads assinados com HMAC SHA-256
  • 8 tipos de evento cobrindo todo o ciclo de vida do pagamento
  • Backoff exponencial por até 7 dias
  • Replay com um clique do dashboard
Gerenciar endpoints

Evento assinado

POST /your-endpoint
Baynoy-Signature: t=1716210000,v1=8b3...
Content-Type: application/json

{
  "id": "evt_2zX...",
  "type": "payment.succeeded",
  "data": { "object": { "id": "pmt_a7c91..." } }
}

Obtenha uma chave, envie uma cobrança

Chaves sandbox são entregues imediatamente. Produção desbloqueia após verificação Tier 1.

Obter chaves API Ler a documentação