baynoy

API & SDK

Une API conçue pour les développeurs

Une API REST avec OpenAPI 3.1, clés d'idempotence, pagination par curseur, et SDKs en JavaScript, Python, PHP, Ruby, Go et C#.

Obtenir des clés API Lire la doc
Développeur travaillant avec l'API Baynoy

<150ms

Latence API P50

99.95%

SLA d'uptime

6

SDKs officiels

  • Spec OpenAPI 3.1
  • Clés d'idempotence
  • Pagination par curseur
  • Auth Bearer
  • Webhooks HMAC
  • Sandbox + cartes de test
  • 6 SDKs officiels
  • Limite 1 000 req/sec
  • SLA d'uptime 99,95%

Créer un paiement

Un endpoint, trente méthodes

Envoyez une seule ressource en POST et Baynoy s'occupe du reste — carte, Apple Pay, Google Pay. Définissez la devise de destination et nous acheminons le versement vers votre banque ou votre wallet au moment du règlement.

  • Idempotency-Key évite les doubles débits au retry
  • Pagination par curseur pour les rapports à gros volume
  • Challenge 3DS inline via checkout_url
  • Les clés sandbox ne touchent jamais de vrai argent

Requête

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

Réponse

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

Démarrage rapide

# 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

Appelez-la depuis n'importe quel langage

Une simple API REST avec authentification Bearer — aucun SDK à installer. Appelez-la avec curl, fetch, requests ou n'importe quel client HTTP. Prête pour la production : réponses versionnées, retries idempotents, webhooks signés et pagination par curseur.

  • Réponses stables et versionnées via l'en-tête Baynoy-Version
  • Idempotency-Key sur chaque POST — un retry ne débite jamais deux fois
  • Webhooks signés HMAC-SHA256 (t=…,v1=…)
  • Pagination par curseur sur chaque endpoint de liste
Lire la doc

Webhooks

Des événements en qui vous pouvez avoir confiance

Chaque webhook est signé en HMAC SHA-256, ré-essayé avec backoff exponentiel jusqu'à 7 jours, et navigable dans votre dashboard avec l'historique complet request / response. Rejouez tout événement passé en un clic.

  • Payloads signés en HMAC SHA-256
  • 8 types d'événements couvrant tout le cycle de vie du paiement
  • Backoff exponentiel jusqu'à 7 jours
  • Replay en un clic depuis le dashboard
Gérer les endpoints

Événement signé

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

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

Obtenez une clé, envoyez un paiement

Les clés sandbox sont disponibles immédiatement. La production se débloque après vérification Tier 1.

Obtenir des clés API Lire la doc