Développeurs

Construire avec Baynoy

Une API REST avec OpenAPI 3.1, clés d'idempotence et webhooks. SDKs typés en JavaScript, Python, PHP, Ruby, Go et C#. Clés sandbox prêtes en 30 secondes.

<150ms

Latence API P50

99.95%

SLA d'uptime

6

SDKs officiels

8

Événements webhook

Démarrage rapide

Créer votre premier paiement

Un POST, n'importe quel moyen de paiement. Passez Idempotency-Key à chaque retry — jamais de double débit.

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" }
  }'

Vérifier un webhook

Signé, ré-essayé, rejouable

Chaque événement est signé en HMAC SHA-256 et ré-essayé jusqu'à 7 jours avec backoff exponentiel. Rejouez toute livraison passée depuis le 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

Appelez-la depuis n'importe quel langage

Baynoy est une simple API REST avec authentification Bearer — aucun SDK à installer. La même requête fonctionne depuis n'importe quel 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_..."},
)

Événements webhook

Huit types, une forme

payment.succeeded

Un paiement a été crédité sur votre solde.

payment.failed

Un paiement a été refusé ou a expiré.

payment.refunded

Un remboursement a été effectué, total ou partiel.

payout.paid

Un payout a atteint le compte ou la wallet de destination.

payout.failed

Un payout a été rejeté et inversé.

dispute.opened

Un titulaire de carte a ouvert un dispute ou un chargeback.

customer.created

Un nouveau client a été ajouté via API ou checkout.

invoice.paid

Une facture récurrente ou ponctuelle a été payée.

Fiabilité

Conçu pour rester debout

Déploiement multi-régions derrière Cloudflare, failover automatique, et paging 24/7 pour notre astreinte SRE. La page de statut publie chaque incident et post-mortem en moins de 48 heures.

  • SLA d'uptime 99,95% sur Pro et au-delà
  • PCI DSS Level 1, SOC 2 Type II (en cours)
  • API versionnée — pas de breaking changes silencieux

Changelog

Dernières versions
  • USDC multi-chaîne + FX locked-rate

    Payouts USDC sur Solana, Base, Ethereum et Polygon avec routage automatique au moindre frais.

    2026-05
  • Hosted Checkout v2

    Pont sandbox, détection automatique de 12 langues, logo personnalisé + couleur d'accent.

    2026-04
  • API REST v1, webhooks, SDKs

    API REST initiale, 8 événements webhook et 5 SDKs officiels publiés.

    2026-03
  • Idempotency-Key obligatoire sur POST

    Protection contre les doubles débits sur les requêtes POST ré-essayées.

    2026-02

Livrer l'intégration ce soir

Clés sandbox, CLI et SDK typé. Production débloquée après vérification Tier 1.