baynoy

API & SDK

Un'API costruita per i builder

Un'API REST con OpenAPI 3.1, chiavi di idempotenza, paginazione cursor e SDK in JavaScript, Python, PHP, Ruby, Go e C#.

Ottieni chiavi API Leggi la documentazione
Sviluppatore che lavora con l'API Baynoy

<150ms

Latenza API P50

99.95%

SLA di uptime

6

SDK ufficiali

  • Spec OpenAPI 3.1
  • Chiavi di idempotenza
  • Paginazione cursor
  • Autenticazione Bearer
  • Webhooks HMAC
  • Sandbox + carte di test
  • 6 SDK ufficiali
  • Limite 1.000 req/sec
  • SLA di uptime 99,95%

Crea un addebito

Un endpoint, trenta metodi

Invia in POST una singola risorsa e Baynoy pensa al resto — carta, Apple Pay, Google Pay. Imposta la valuta di destinazione e indirizziamo il pagamento alla tua banca o al tuo wallet al momento del regolamento.

  • Idempotency-Key previene doppi addebiti al retry
  • Paginazione cursor per report ad alto volume
  • Challenge 3DS inline tramite checkout_url
  • Le chiavi sandbox non toccano mai denaro reale

Richiesta

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

Risposta

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

Avvio rapido

# 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

Chiamala da qualsiasi linguaggio

Una semplice API REST con autenticazione Bearer — nessun SDK da installare. Chiamala con curl, fetch, requests o qualsiasi client HTTP. Pronta per la produzione: risposte versionate, retry idempotenti, webhook firmati e paginazione a cursore.

  • Risposte stabili e versionate tramite l'header Baynoy-Version
  • Idempotency-Key su ogni POST — un retry non addebita mai due volte
  • Webhook firmati con HMAC-SHA256 (t=…,v1=…)
  • Paginazione a cursore su ogni endpoint di elenco
Leggi la documentazione

Webhooks

Eventi di cui ti puoi fidare

Ogni webhook è firmato con HMAC SHA-256, riprovato con backoff esponenziale fino a 7 giorni e navigabile nella tua dashboard con la cronologia completa request / response. Riproduci qualunque evento passato con un click.

  • Payload firmati HMAC SHA-256
  • 8 tipi di evento che coprono l'intero ciclo di vita del pagamento
  • Backoff esponenziale fino a 7 giorni
  • Replay con un click dalla dashboard
Gestisci endpoint

Evento firmato

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

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

Ottieni una chiave, invia un addebito

Le chiavi sandbox sono disponibili subito. La produzione si sblocca dopo la verifica Tier 1.

Ottieni chiavi API Leggi la documentazione