baynoy

API & SDK

Una API construida para desarrolladores

Una API REST con OpenAPI 3.1, claves de idempotencia, paginación por cursor y SDKs en JavaScript, Python, PHP, Ruby, Go y C#.

Obtener claves API Leer la documentación
Desarrollador trabajando con la API de Baynoy

<150ms

Latencia API P50

99.95%

SLA de uptime

6

SDKs oficiales

  • Spec OpenAPI 3.1
  • Claves de idempotencia
  • Paginación por cursor
  • Autenticación Bearer
  • Webhooks HMAC
  • Sandbox + tarjetas de prueba
  • 6 SDKs oficiales
  • Límite 1.000 req/sec
  • SLA de uptime 99,95%

Crear un cobro

Un endpoint, treinta métodos

Haz un POST a un único recurso y Baynoy se encarga del resto — tarjeta, Apple Pay, Google Pay. Define la moneda de destino y enrutamos el pago a tu banco o wallet en el momento de la liquidación.

  • Idempotency-Key evita dobles cobros en retry
  • Paginación por cursor para reportes de alto volumen
  • Challenge 3DS inline vía checkout_url
  • Las claves sandbox nunca tocan dinero real

Solicitud

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

Respuesta

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

Inicio rápido

# 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

Llámala desde cualquier lenguaje

Una API REST sencilla con autenticación Bearer — sin SDK que instalar. Llámala con curl, fetch, requests o cualquier cliente HTTP. Lista para producción: respuestas versionadas, reintentos idempotentes, webhooks firmados y paginación por cursor.

  • Respuestas estables y versionadas mediante la cabecera Baynoy-Version
  • Idempotency-Key en cada POST — un reintento nunca cobra dos veces
  • Webhooks firmados con HMAC-SHA256 (t=…,v1=…)
  • Paginación por cursor en cada endpoint de listado
Leer la documentación

Webhooks

Eventos en los que puedes confiar

Cada webhook está firmado con HMAC SHA-256, se reintenta con backoff exponencial hasta 7 días, y es navegable en tu dashboard con historial completo de request / response. Reproduce cualquier evento pasado con un clic.

  • Payloads firmados con HMAC SHA-256
  • 8 tipos de evento que cubren todo el ciclo de vida del pago
  • Backoff exponencial hasta 7 días
  • Replay con un clic desde el dashboard
Gestionar endpoints

Evento firmado

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

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

Obtén una clave, envía un cobro

Las claves sandbox se entregan al instante. Producción se desbloquea después de la verificación Tier 1.

Obtener claves API Leer la documentación