Sviluppatori
Un'API REST con OpenAPI 3.1, chiavi di idempotenza e webhooks. SDK tipizzati in JavaScript, Python, PHP, Ruby, Go e C#. Chiavi sandbox pronte in 30 secondi.
<150ms
Latenza API P50
99.95%
SLA di uptime
6
SDK ufficiali
8
Eventi webhook
Ottieni una chiave
Registrati, vai a Developers nella dashboard. Chiavi sandbox attive subito.
Crea accountLeggi la documentazione
Quickstart in 6 lingue, riferimento API, ricette per le integrazioni più richieste.
Apri documentazioneProva il sandbox
Simula carte, USDC, rimborsi e dispute — niente soldi reali, niente rate limit.
Chiavi sandboxQuickstart
Un POST, qualunque metodo di pagamento. Passa Idempotency-Key a ogni retry — non addebiterai mai due volte.
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" }
}'Verifica un webhook
Ogni evento è firmato con HMAC SHA-256 e riprovato fino a 7 giorni con backoff esponenziale. Riproduci qualunque consegna passata dalla 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
Baynoy è una semplice API REST con autenticazione Bearer — nessun SDK da installare. La stessa richiesta funziona da qualsiasi client 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_..."},
)Eventi webhook
payment.succeeded
Un pagamento è stato accreditato sul tuo saldo.
payment.failed
Un pagamento è stato rifiutato o scaduto.
payment.refunded
Un rimborso è stato completato, totale o parziale.
payout.paid
Un payout ha raggiunto il conto o il wallet di destinazione.
payout.failed
Un payout è stato rifiutato e annullato.
dispute.opened
Un titolare di carta ha aperto una dispute o chargeback.
customer.created
Un nuovo cliente è stato aggiunto tramite API o checkout.
invoice.paid
Una fattura ricorrente o una tantum è stata pagata.
Affidabilità
Deployment multi-regione dietro Cloudflare, failover automatico e paging 24/7 per il nostro SRE on-call. La pagina di stato pubblica ogni incidente e post-mortem entro 48 ore.
Changelog
Ultime releaseUSDC multi-chain + FX a tasso bloccato
Payout USDC su Solana, Base, Ethereum e Polygon con routing automatico alla commissione più bassa.
Hosted Checkout v2
Ponte sandbox, rilevamento automatico di 12 lingue, logo personalizzato + colore di accento.
API REST v1, webhooks, SDK
API REST iniziale, 8 eventi webhook e 5 SDK ufficiali rilasciati.
Idempotency-Key obbligatoria su POST
Protezione contro doppio addebito su richieste POST riprovate.
Chiavi sandbox, una CLI e un SDK tipizzato. La produzione si sblocca dopo la verifica Tier 1.