Construye con el pueblo, sobre la API de Coastly

Inicio rápido

Tres pasos hasta tu primera reserva. Una clave pertenece a un solo negocio y solo ve los datos de ese negocio.

1. Crea una clave de API

En tu panel de vendedor de Coastly, abre Desarrolladores y crea una clave. Elige los permisos que necesitas y copia el secreto; se muestra una sola vez.

# Vendor dashboard > Developers > Create API key.
# Copy the ck_live_ (or ck_test_) secret. It is shown once.

export COASTLY_KEY="ck_test_..."

2. Haz tu primera solicitud

Lista las reservas para confirmar que tu clave funciona. Cada respuesta incluye un encabezado X-Request-Id para soporte.

curl https://coastly.surf/api/v1/reservations \
  -H "Authorization: Bearer $COASTLY_KEY"

{
  "data": [
    {
      "id": "res_9Fq2c8",
      "property_id": "prop_1a2b3c",
      "status": "confirmed",
      "check_in": "2026-07-12",
      "check_out": "2026-07-15",
      "guests": 2,
      "guest_name": "Ana Rivera",
      "total": { "amount": 42000, "currency": "USD" }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

3. Crea una reserva

Las escrituras requieren un Idempotency-Key. Reintentar con la misma clave y el mismo cuerpo repite la respuesta guardada en lugar de reservar dos veces.

curl -X POST https://coastly.surf/api/v1/reservations \
  -H "Authorization: Bearer $COASTLY_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f9a1c7e-2b6d-4a11-9c2e-8d7f4b1a0e55" \
  -d '{
    "property_id": "prop_1a2b3c",
    "check_in": "2026-07-12",
    "check_out": "2026-07-15",
    "guests": 2,
    "rooms": [{ "room_type_id": "rt_ocean_king", "units": 1, "guests": 2 }],
    "guest_name": "Ana Rivera",
    "guest_email": "ana@example.com"
  }'
# The guest pays the business directly. Coastly holds no funds.

Cómo funciona el dinero en la API

Ningún endpoint cobra una tarjeta ni envía un pago, porque Coastly no está en el flujo del pago del mercado. El huésped le paga directamente al negocio: efectivo, un medio local (Yappy en Panamá, SINPE en Costa Rica, SPEI en México) o el enlace de tarjeta del propio negocio.

• La comisión se registra solo en ventas verificadas, las que confirman tanto el huésped como el negocio.
• Coastly factura su comisión cada semana, los viernes. Nunca se descuenta de una venta.
• La tarifa de entrega no lleva comisión de Coastly.

No supongas una tarifa única: depende del tipo de venta. Lee la comisión registrada en /commission y las facturas emitidas en /invoices.

Qué puedes construir

Guías

Recorridos prácticos para las integraciones más comunes.