Desenvolvedores
Uma API REST com OpenAPI 3.1, chaves de idempotência e webhooks. SDKs tipados em JavaScript, Python, PHP, Ruby, Go e C#. Chaves sandbox prontas em 30 segundos.
<150ms
Latência API P50
99.95%
SLA de uptime
6
SDKs oficiais
8
Eventos webhook
Obter uma chave
Cadastre-se, vá em Developers no dashboard. Chaves sandbox ativas imediatamente.
Criar contaLer a documentação
Guias rápidos em 6 idiomas, referência API, receitas para as integrações mais solicitadas.
Abrir documentaçãoTestar o sandbox
Simule cartões, USDC, reembolsos e disputas — sem dinheiro real, sem rate limits.
Chaves sandboxInício rápido
Um POST, qualquer método de pagamento. Passe Idempotency-Key em cada retry — nunca vai cobrar duas vezes.
curl https://api.baynoy.com/v1/payments \
-H "Authorization: Bearer sk_test_••••" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"amount": 4900,
"currency": "USD",
"methods": ["card","usdc"],
"payout": { "type": "bank", "currency": "USD" }
}'Verifique um webhook
Cada evento é assinado com HMAC SHA-256 e reentregue por até 7 dias com backoff exponencial. Reproduza qualquer entrega passada do dashboard.
import crypto from "node:crypto";
export async function POST(req: Request) {
const header = req.headers.get("Baynoy-Signature")!; // t=...,v1=...
const body = await req.text();
const { t, v1 } = Object.fromEntries(
header.split(",").map((p) => p.split("=")),
);
const expected = crypto
.createHmac("sha256", process.env.BAYNOY_WHSEC!)
.update(`${t}.${body}`)
.digest("hex");
if (v1 !== expected) return new Response("bad signature", { status: 401 });
const evt = JSON.parse(body); // evt.type === "payment.succeeded"
return new Response("ok");
}API REST
A Baynoy é uma API REST simples com autenticação Bearer — sem SDK para instalar. A mesma requisição funciona em qualquer cliente HTTP.
cURL
curl https://baynoy.com/api/v1/payments \
-H "Authorization: Bearer sk_live_..."JavaScript / TypeScript
await fetch("https://baynoy.com/api/v1/payments", {
headers: { Authorization: "Bearer sk_live_..." },
});Python
requests.get(
"https://baynoy.com/api/v1/payments",
headers={"Authorization": "Bearer sk_live_..."},
)Eventos webhook
payment.succeeded
Um pagamento foi creditado no seu saldo.
payment.failed
Um pagamento foi recusado ou expirou.
payment.refunded
Um reembolso foi concluído, total ou parcial.
payout.paid
Um pagamento chegou à conta ou wallet de destino.
payout.failed
Um pagamento foi rejeitado e revertido.
dispute.opened
Um portador de cartão abriu uma disputa ou chargeback.
customer.created
Um novo cliente foi adicionado via API ou checkout.
invoice.paid
Uma fatura recorrente ou única foi paga.
Confiabilidade
Implantação multi-região atrás do Cloudflare, failover automático e paging 24/7 para o nosso SRE on-call. A página de status publica cada incidente e post-mortem em menos de 48 horas.
Changelog
Últimas releasesUSDC multi-chain + FX com taxa travada
Pagamentos USDC em Solana, Base, Ethereum e Polygon com roteamento automático de menor taxa.
Hosted Checkout v2
Ponte sandbox, detecção automática de 12 idiomas, logo customizado + cor de destaque.
API REST v1, webhooks, SDKs
API REST inicial, 8 eventos webhook e 5 SDKs oficiais lançados.
Idempotency-Key obrigatória em POST
Proteção contra dupla cobrança em requisições POST repetidas.
Chaves sandbox, CLI e SDK tipado. Produção desbloqueia após verificação Tier 1.