Saltar al contenido principal

Documentación de la API de OrcaRail: pasarela de pagos con criptomonedas

Bienvenido a la documentación de la API de OrcaRail. OrcaRail ofrece una API y SDK estándar y fáciles de usar para aceptar pagos con criptomonedas mediante stablecoins (monedas estables) como USDT y USDC.

Inicio rápido​

  1. Abre el Panel y regístrate (o inicia sesión); consulta Crear una cuenta.
  2. Crea tu primera organización después de iniciar sesión. OrcaRail necesita una organización antes de que puedas continuar en el panel.
  3. Crea claves de API desde Panel → API Keys.
  4. Usa el SDK de Node.js o el SDK de PHP, o prueba la demo.
  5. Crea un Payment Intent para empezar a aceptar pagos.

¿Qué es OrcaRail?​

OrcaRail es una pasarela de pagos cripto que te permite cobrar a tus clientes con stablecoins. Con OrcaRail puedes:

  • ✅ Aceptar pagos con stablecoins (USDC, USDT, etc.)
  • ✅ Crear payment intents con página de pago alojada (hosted pay)
  • ✅ Recibir notificaciones de webhook en tiempo real
  • ✅ Admitir varias redes blockchain (visión general multichain)
  • ✅ Cobrar pagos recurrentes con suscripciones, incluido el cobro automático (auto-charge) en EVM y Solana
  • ✅ Gestionar pagos con una API y SDK estándar y sencillos

Precios: OrcaRail alojado cuesta 0,5 % de cada transacción completada, con las primeras 1.000 transacciones gratis; la instalación autoalojada (self-hosted) no tiene coste de software por nuestra parte. Los SDK, el MCP y los plugins tienen licencia MIT; el stack alojado api / app / pay no es de código abierto. Las cotizaciones de pago pueden incluir conceptos opcionales separados (soporte, comisión, puente); consulta Comisiones y límites.

Funciones principales​

Payment Intents​

Crea Payment Intents para cobrar a tus clientes. El flujo es sencillo:

  1. Crea un Payment Intent
  2. Confírmalo para obtener una URL de redirección
  3. Redirige a tus clientes a la página de pago alojada
  4. Recibe notificaciones de webhook

Más información sobre Payment Intents →

Suscripciones​

Cobra pagos recurrentes con criptomonedas mediante la API de suscripciones de OrcaRail: intervalos fijos, periodos de prueba, enlaces de pago por ciclo o cobro automático (cargo periódico tras la aprobación del pagador en EVM o Solana).

Visión general de las suscripciones →

Multichain​

Acepta pagos en muchas redes, configura direcciones de retiro por tipo de cadena y mantén sincronizadas las redes y tokens admitidos con Relay. Las listas actualizadas están en Redes y tokens.

Visión general multichain →

Webhooks​

Recibe notificaciones en tiempo real de los eventos de pago:

  • payment_intent.completed - Pago completado
  • payment_intent.processing - Pago en proceso
  • payment_intent.canceled - Pago cancelado

Configura webhooks por clave de API y supervisa las entregas con los registros de webhooks.

Más información sobre webhooks →

Autenticación​

OrcaRail admite dos métodos de autenticación:

  • Bearer Tokens (JWT) - Para solicitudes autenticadas por un usuario
  • Claves de API (Basic Auth) - Para solicitudes de servidor a servidor

Más información sobre autenticación →

SDK de Node.js​

Integra pagos con el SDK oficial. Instálalo desde npm: @orcarail/node.

  • Crear y confirmar Payment Intents
  • Pagar por slug
  • Verificar firmas de webhook y procesar eventos

Guía del SDK de Node.js →

SDK de PHP​

Integra pagos desde PHP 8.1+ con el paquete oficial de Composer orcarail/orcarail-php.

  • Un único OrcaRailClient con servicios lazy
  • Payment Intents, suscripciones, pago por slug, catálogo y tipos de cambio
  • Verificar firmas de webhook y procesar eventos

Guía del SDK de PHP →

Servidor MCP​

Conecta agentes de programación con IA — Claude Code, Cursor, Codex — con el servidor oficial de Model Context Protocol @orcarail/mcp.

  • Crear y confirmar Payment Intents desde tu agente
  • Gestionar suscripciones, productos y precios
  • Consultar tipos de cambio y detalles de la página de pago (sin credenciales para rates.* / pay.*)

Guía del servidor MCP →

App de demostración​

Ejecuta la demo de código abierto para ver el flujo completo: crear el intent, redirigir a la página de pago, página de éxito y webhooks.

Guía de la app de demostración →

Primeros pasos​

¿Eres nuevo en OrcaRail? Empieza aquí:

En tu primera sesión del panel debes crear una organización antes de poder crear claves de API.

  1. Primeros pasos - Crea una cuenta, una organización y claves de API
  2. SDK de Node.js - Integra con @orcarail/node, o con el SDK de PHP mediante orcarail/orcarail-php
  3. App de demostración - Ejecuta la demo de código abierto (GitHub)
  4. Guía de Payment Intents - Aprende a aceptar pagos
  5. Guía de webhooks - Configura las notificaciones de pago
  6. Configuración de webhooks - Configura webhooks para tus claves de API
  7. Suscripciones - Pagos recurrentes y cobro automático
  8. Multichain - Redes, retiros y alineación con Relay
  9. Referencia de la API - Documentación completa de la API

¿Necesitas ayuda?​

Soporte​

Para obtener ayuda, escríbenos a [email protected] o visita nuestro repositorio de GitHub.