Saltar al contenido principal

Visión general de Payment Intents

Los Payment Intents son la forma principal de aceptar pagos cripto con OrcaRail. Ofrecen una manera segura y flexible de cobrar a tus clientes.

¿Qué son los Payment Intents?​

Un Payment Intent representa tu intención de cobrar un pago a un cliente. Sigue el ciclo de vida del pago desde su creación hasta su finalización.

El flujo de Payment Intent usa un patrón conocido de crear–confirmar–redirigir para pagos con stablecoins:

  1. Crea un PaymentIntent para recibir un client_secret
  2. Confirma el intent para recibir un next_action.redirect_to_url.url
  3. Redirige al usuario a la app de pago alojada
  4. Tras confirmarse el pago, el usuario vuelve a tu return_url con parámetros de consulta

Estados del Payment Intent​

Los Payment Intents pasan por varios estados durante su ciclo de vida:

  • requires_payment_method: el PaymentIntent se ha creado, pero aún no tiene un método de pago asociado
  • requires_confirmation: el PaymentIntent tiene un método de pago asociado, pero hay que confirmarlo
  • processing: el PaymentIntent se está procesando
  • succeeded: el PaymentIntent se ha completado y el pago se ha procesado
  • canceled: el PaymentIntent se ha cancelado

Métodos de pago admitidos​

Actualmente, OrcaRail admite:

  • Cripto: pagos con stablecoins (USDC, USDT, etc.)

Redes admitidas​

OrcaRail admite pagos en varias redes blockchain. Debes indicar tanto tokenId como networkId al crear un Payment Intent.

Entre las redes habituales están:

  • Ethereum
  • Polygon
  • Base
  • Arbitrum

Para ver todas las redes y monedas admitidas (con la tecnología de Relay y actualizadas automáticamente), consulta nuestro blog: Redes y monedas compatibles.

Flujo de pago​

Conceptos clave​

Client secret​

El client_secret es un identificador único de un Payment Intent. Se usa para confirmar el Payment Intent y debe mantenerse en secreto. Solo se muestra una vez, al crear el Payment Intent.

URL de retorno​

La return_url es adonde se redirige a los clientes tras completar o cancelar un pago. Debes gestionar en esa página tanto los casos de éxito como los de fallo.

Metadatos​

Puedes adjuntar metadata personalizados a los Payment Intents. Es útil para guardar información adicional sobre el pago, como ID de pedido o datos del cliente.

Dirección de retiro​

Al crear o actualizar un Payment Intent, puedes definir opcionalmente withdrawal_addresses (objeto clave-valor: tipo de cadena a dirección, por ejemplo { "evm": "0x...", "solana": "..." }). Si se define para un tipo de cadena, los fondos se retiran a esa dirección cuando se ejecuta el retiro automático. Si se omite o está vacío para una cadena, se usa el valor por defecto de tu cuenta en la configuración de retiros para ese tipo de cadena.

Comisiones y mínimos​

Uso alojado: consulta Precios de la plataforma alojada para ver el precio por transacción y el plan gratuito de OrcaRail en la nube.

Por pago (cotización): los pagos pueden incluir una comisión de soporte, una comisión (de tu clave de API) y una comisión de puente cuando el pagador usa otro token u otra red. Los importes también están sujetos a mínimos de pago y a mínimos de retiro opcionales. Para todos los detalles, consulta Comisiones y límites.

Próximos pasos​