Geliştiriciler
OpenAPI 3.1, idempotency anahtarları ve webhook'lar ile REST API. JavaScript, Python, PHP, Ruby, Go ve C#'ta tipli SDK'lar. Sandbox anahtarları 30 saniyede hazır.
<150ms
P50 API gecikme
99.95%
Çalışma süresi SLA
6
Resmi SDK
8
Webhook olayı
Anahtar al
Kayıt ol, dashboard'daki Geliştiriciler bölümüne git. Sandbox anahtarları hemen aktif.
Hesap oluşturDokümanları oku
6 dilde hızlı başlangıçlar, API referansı, en sık sorulan entegrasyonlar için tarifler.
Dokümanları açSandbox'ı dene
Kart, USDC, iade ve uyuşmazlıkları simüle et — gerçek para yok, rate limit yok.
Sandbox anahtarı alHızlı başlangıç
Tek POST, herhangi bir ödeme yöntemi. Her retry'da Idempotency-Key gönder, asla çift ücret çekmezsin.
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" }
}'Webhook'u doğrula
Her event HMAC SHA-256 ile imzalanır ve 7 gün boyunca exponential backoff ile yeniden denenir. Dashboard'dan geçmiş bir teslimatı tekrar oynat.
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");
}REST API
Baynoy, Bearer kimlik doğrulamalı düz bir REST API'dir — kurulacak SDK yok. Aynı istek her HTTP istemcisinden çalışır.
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_..."},
)Webhook olayları
payment.succeeded
Bakiyenize bir ödeme düştü.
payment.failed
Bir ödeme reddedildi veya zaman aşımına uğradı.
payment.refunded
Bir iade tamamlandı, tam veya kısmi.
payout.paid
Bir çıkış hedef hesaba veya cüzdana ulaştı.
payout.failed
Bir çıkış reddedildi ve geri çevrildi.
dispute.opened
Bir kart sahibi uyuşmazlık veya chargeback açtı.
customer.created
API veya checkout üzerinden yeni bir müşteri eklendi.
invoice.paid
Yinelenen veya tek seferlik bir fatura ödendi.
Güvenilirlik
Cloudflare arkasında çoklu-bölge dağıtımı, otomatik failover ve 24/7 SRE on-call paging. Status sayfası her olayı ve post-mortem'i 48 saat içinde yayınlar.
Sürüm notları
Son sürümlerMulti-chain USDC + sabit kur FX
Solana, Base, Ethereum ve Polygon üzerinde otomatik en-düşük-ücret yönlendirme ile USDC ödemeleri.
Hosted Checkout v2
Sandbox köprüsü, 12 dilde otomatik tespit, özel logo + accent rengi.
REST API v1, webhook'lar, SDK'lar
İlk REST API, 8 webhook event ve 5 resmi SDK yayında.
POST'ta Idempotency-Key zorunlu
Yeniden denenen POST isteklerinde çift ücret koruması.
Sandbox anahtarları, CLI ve tipli SDK. Üretim Tier 1 doğrulamasından sonra açılır.