SPEI

La solución de PayOut usando SPEI proporciona servicios para enviar fondos desde una cuenta bancaria mexicana a beneficiarios externos en México utilizando la red de pagos en tiempo real SPEI.

Los SPEI PayOuts se utilizan comúnmente para desembolsar fondos de manera eficiente a cuentas bancarias o tarjetas de débito, ofreciendo una experiencia de pago rápida, confiable y ampliamente adoptada en México.

Contrapartes soportadas

PayOut vía SPEI soporta los siguientes tipos de destino en México:

Tipo de Destino	Tipo de Contraparte	Rails
Cuenta CLABE	`clabe`	SPEI
Tarjeta SPEI	`spei_card`	SPEI

Flujo de Autorización (opcional)

Checker Approval es una solución opcional que puede ser utilizada dentro del flujo de PayOut. Activa un flujo de autorización antes de que la transacción sea enviada a la red de pagos. Mientras la aprobación está pendiente, el Money Movement permanece en estado pending_approval hasta que es aprobado o rechazado. El proceso de aprobación puede completarse a través del Portal Cobre o programáticamente vía API.

Ciclo de vida del Payout

Un PayOut a través de SPEI sigue un ciclo de vida simple:

1. Crear una Contraparte (beneficiario)
Crea una Contraparte con la información del beneficiario.
Esta contraparte representa el destino de la transacción SPEI PayOut.

2. Crear un Money Movement
Crea un Money Movement usando:

El account_id desde el cual los fondos serán debitados, usado como source_id.

El counterparty_id del paso anterior como destination_id

Los metadatos con una description y reference

El external_id donde puedes usar para enviar una referencia desde tu sistema.

El monto proporcionado en la unidad más pequeña de la moneda (ej., 100.00 MXN debe representarse como 10000).

El checker_approval como true si quieres usar nuestro flujo de autorización.

3. El Money Movement es procesado
Una vez creado, el Money Movement inicia en el estado initiated.

Si todas las validaciones pasan, el estado cambia a processing. En este punto, la transacción es enviada a través de SPEI

Si ocurre un error durante la validación o procesamiento, el Money Movement transiciona al estado final failed.

Si el Money Movement es creado con checker_approval = true, primero se mueve al estado pending_approval y solo transicionará a processing o canceled una vez que se tome la decisión de aprobación.

4. Los fondos son debitados
Una vez que el Money Movement transiciona al estado processing, los fondos son debitados del Cobre Balance asociado.

5. Esperar el resultado final del Money Movement.

Si el Money Movement está completed, el beneficiario ha recibido exitosamente los fondos.

Si el Money Movement está rejected, los fondos son acreditados de vuelta a tu Cobre Balance.

6. Recibir actualizaciones de estado
Los cambios de estado del Money Movement son comunicados vía Webhooks.

Acciones realizadas en un Money Movement (Payout)

🔑 Crear

🔍 Consulta

Descripción: Creación de Money Movement.
Qué esperar después de la acción: Money Movement es creado en Cobre.
📘 Aprende más:

🔗 Crear un Money Movement

Idempotencia de Money Movement

La creación de Money Movement soporta idempotencia.

Las claves de idempotencia son válidas por 24 horas.

Cómo Comenzar

Antes de empezar, recomendamos revisar las siguientes consideraciones.

Antes de usar esta API

Necesitas un Cobre Balance en México

Para enviar fondos usando SPEI, debes tener una cuenta activa de Cobre Balance en México con fondos suficientes.

Crear la Contraparte beneficiario

Antes de crear un Money Movement de PayOut, debes crear una Contraparte con la información del beneficiario, que coincida con el tipo de destino seleccionado.

Definir la configuración del PayOut

Decide el tipo de destino, monto, y cualquier metadato requerido necesario para procesar el PayOut.

Implementar Webhooks para rastrear el estado del pago

Para mantenerte informado sobre el estado de las transacciones de PayOut, recomendamos fuertemente implementar Webhooks. Los Webhooks notifican a tu sistema cuando un pago es iniciado, procesado, completado, o falló. También suscríbete a los eventos requeridos para recibir notificaciones sobre débitos y créditos de transacciones.

Ve Notificaciones y Suscripciones para más detalles.

Qué esperar después de usar esta API

Iniciar el PayOut

Una vez que la solicitud de creación de Money Movement es enviada, será creada con estado initiated.
Asegúrate de que tu sistema esté preparado para recibir actualizaciones de estado mientras el Money Movement progresa a través de su ciclo de vida.

Rastrear el estado de la transacción

Monitorea el ciclo de vida del PayOut usando Webhooks o endpoints de consulta.

Los fondos son entregados al beneficiario

Cuando el PayOut es exitoso, los fondos son acreditados a la cuenta del beneficiario y el estado del Money Movement es actualizado correspondientemente.

SPEI

Contrapartes soportadas#

Flujo de Autorización (opcional)#

Ciclo de vida del Payout#

Acciones realizadas en un Money Movement (Payout)#

Idempotencia de Money Movement#

Cómo Comenzar#

Antes de usar esta API#

Qué esperar después de usar esta API#