Interactuando con ACH en línea
En Kamin Ledger, cada movimiento de dinero comienza con un Intent.
Un intent es una instrucción firmada que representa un cambio propuesto en el sistema, comúnmente la transferencia de saldos entre billeteras.
Cada intent debe ser firmada digitalmente por su autor utilizando su llave privada, lo que garantiza tanto la integridad como la autenticidad de la operación.
Una vez enviada, una intent progresa a través de un ciclo de vida definido por su meta.status, con los siguientes estados finales:
completed: La intent fue ejecutada exitosamente.rejected: La intent fue inválida o falló.
Una vez que una intent alcanza un estado final, se vuelve inmutable.
Esquemas e integración con rieles
Kamin soporta integración con varios rieles de pago, como ACH en línea.
Cada riel define su propio esquema, el cual especifica la estructura requerida y los campos de datos para las intenciones sobre ese riel.
ACH en línea es el riel que estas guías llamaban antes Transfiya, y es el
mismo producto. Cambió el nombre, no la integración: el handle del wallet en
cada petición sigue siendo transfiya y las direcciones conservan el sufijo
@transfiya. Consulta Sobre
Transfiya.
Antes de iniciar una transferencia a través de ACH en línea, primero debes identificar la dirección del usuario en el riel que estará involucrado en la transacción.
Para una descripción general de los formatos de direccionamiento, consulta la guía Sobre direcciones.
Tipos de transferencias en ACH en línea
| Tipo | Esquema | Descripción | Rol del autor de la intent |
|---|---|---|---|
SEND | transfer | Transferencia desde un negocio en Kamin hacia una dirección de usuario en ACH en línea | El creador de la intent es el origen |
SEND | a2a | Transferencia desde un negocio en Kamin hacia una cuenta bancaria específica | El creador de la intent es el origen |
Próximos pasos
- Cómo obtener un destinatario en ACH en línea para identificar la dirección correcta del receptor.
- Cómo manejar los webhooks de ACH en línea para recibir la notificación cuando una transferencia se liquida o se rechaza.
- Cómo crear una dispersión de negocio a persona (B2P) para acreditar a un usuario en el riel.
- Cómo enviar una transferencia cuenta a cuenta (A2A) para acreditar una cuenta bancaria específica.
Para profundizar en los detalles técnicos, visita la Referencia del API.
Historial de cambios
- Cambiado• Sección renombrada a ACH en línea
- Cambiado• Se actualizó la lista de guías de la sección
- Eliminado• Se eliminó la fila REQUEST de la tabla de tipos
- Agregado• Enlace y fila de la transferencia cuenta a cuenta
- Agregado• Enlace a la guía de webhooks
- Eliminado• Se retiró el enlace a la guía R2P
- Cambiado• Renombrado de Transfiya a ACH en línea
- Agregado• Versión inicial