Cada flujo en el app que involucra una llamada a una API de fiserv se describe en este documento. Las llamadas de API condicionadas se sombrean en naranja, la condición se detalla en la columna descripción.
NOTA: Si una llamada se repite en un flujo, estará repetida.
Login
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validar si el cliente esta autorizado para acceder al APP. El api devuelve también el saldo y se usa para pasarlo al app y lo pinte en el home. |
Home
API | Descripción |
|---|---|
POST cards/embosser/details | Consulta de bloqueos de tarjeta |
Cash in en tienda Oxxo
API | Descripción |
|---|---|
POST account/balance/details | Solo si es con tarjeta física el depósito, se usa para conocer el número de cuenta de la tarjeta para identificar al cliente Spin. |
POST account/organizationNumber/level-limits/validate-amount | Validación de límites de cuenta |
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de abono. |
Cash Out en tienda con QR en APP
1.1 Generación de QR
API | Descripción |
|---|---|
POST account/balance/details | Validación de límites de nivel de cuenta y saldo suficiente. |
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
1.2 Cobro en tienda
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de retiro. |
Cash Out en tienda con QR vía SMS (usuario sin cuenta SPIN)
1.1 Generación de QR y envío por SMS
API | Descripción |
|---|---|
POST account/balance/details | Validación de límites de nivel de cuenta y saldo suficiente. |
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/QRFL-balance | Transacción de reserva(congelamiento) de saldo. |
1.2 Cobro en tienda
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/QRFL-balance | Transacción de liberación (descongelado) de saldo |
PUT account/FL-balance | Transacción de retiro (débito). |
PUT account/FL-balance | Transacción de cobro de comisión por retiro (débito). |
PUT account/FL-balance | En caso de error después de haber cobrado, se hace una transacción de reversa del débito. |
PUT account/FL-balance | En caso de error después de haber cobrado la comisión, se hace una transacción de reversa del débito. |
Dispersión SPEI (SPEI Out)
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de retiro (débito). |
PUT account/FL-balance | Transacción de cobro de comisión por retiro (débito). |
PUT account/FL-balance | En caso de error después de haber cobrado, se hace una transacción de reversa del débito. |
PUT account/FL-balance | En caso de error después de haber cobrado la comisión, se hace una transacción de reversa del débito. |
Abono SPEI (SPEI In)
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de abono (crédito). |
Cash In en APP
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de abono (crédito). |
Pago de servicios y compra de tiempo aire
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de retiro (débito). |
PUT account/FL-balance | Transacción de cobro de comisión por retiro (débito). |
PUT account/FL-balance | En caso de error después de haber cobrado, se hace una transacción de reversa del débito. |
PUT account/FL-balance | En caso de error después de haber cobrado la comisión, se hace una transacción de reversa del débito. |
Compra de tarjeta de regalo
API | Descripción |
|---|---|
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de retiro (débito). |
PUT account/FL-balance | En caso de error después de haber cobrado, se hace una transacción de reversa del débito. |
Cobro de remesa
API | Descripción |
|---|---|
POST account/organizationNumber/level-limits/validate-amount | Validación de límites |
POST account/details | Obtención de códigos de bloqueo para validación de los mismos. |
PUT account/FL-balance | Transacción de abono |
Activación
API | Descripción |
|---|---|
POST cards/embosser/details | Obtención del número de cuenta asociado a un pantoken. |
POST customer | Alta del cliente. |
PUT /account/customer | Vinculación del cliente creado al número de cuenta asociado a la tarjeta. |
PUT /cards/activation | Activación de la tarjeta. |
Reverso de Activación
API | Descripción |
|---|---|
POST cards/embosser/details | Obtención de detalle de tarjeta para validar status que no esté bloqueada. |
PUT /cards/activation | Desactivación de la tarjeta. |
PUT /customer | Reset de info demográfica y personal del cliente a valores default. |
PUT /account/qualification | Reset del nivel de cuenta. |
Vinculación
1.1 Generación del código de vinculación
API | Descripción |
|---|---|
POST cards/embosser/details | Si el cliente tiene una tarjeta al momento de solicitar el código de vinculación, se obtiene de detalle para validar que la tarjeta esté activa |
POST cards/embosser/details | Si el cliente tiene una tarjeta bloqueada al momento de solicitar el código de vinculación, se validan sus códigos de bloqueo para verificar que tenga permitido solicitar un código de vinculación. |
1.2 Consumo de código de vinculación en tienda
API | Descripción |
|---|---|
POST cards/embosser/details | Obtención del número de cuenta asociado a un pantoken. |
PUT /account/prepaid | Vinculación del número de cuenta del cliente al pan token del plástico. |
PUT /cards/activation | Activación de la nueva tarjeta. |
Reverso de vinculación
API | Descripción |
|---|---|
POST cards/embosser/details | Obtención de detalle de tarjeta para validar que no esté ya bloqueada y esté activa |
PUT /cards/activation | Desactivación de la nueva tarjeta. |
PUT /account/prepaid | Vinculación de pan token a cuenta previamente asignada (la que tenía de origen). |
Alta de cuenta canal mobile
API | Descripción |
|---|---|
POST /customer | Alta de cliente |
POST /account | Desactivación de la nueva tarjeta. |
Colocar código de bloqueo a cliente
Código de bloqueo de nivel cuenta
API | Descripción |
|---|---|
POST /account/details | Obtención de códigos actuales que tiene el cliente de nivel cuenta. |
POST cards/embosser/details | Obtención de códigos actuales que tiene el cliente de nivel tarjeta. |
PUT account/block-code | Añadir bloqueo de cuenta. |
Código de bloqueo de nivel tarjeta
API | Descripción |
|---|---|
POST /account/details | Obtención de códigos actuales que tiene el cliente de nivel cuenta. |
POST cards/embosser/details | Obtención de códigos actuales que tiene el cliente de nivel tarjeta. |
POST /cards/embosser/details | Obtención de detalle de tarjeta para validar que la tarjeta esté activa y no esté ya bloqueada. |
PUT cards/embosser/block | Añadir bloqueo de tarjeta. |
Remover código de bloqueo
Código de bloqueo de nivel cuenta
API | Descripción |
|---|---|
POST /account/details | Obtención de códigos actuales que tiene el cliente de nivel cuenta. |
POST cards/embosser/details | Obtención de códigos actuales que tiene el cliente de nivel tarjeta. |
PUT account/block-code | Eliminar bloqueo de cuenta. |
Código de bloqueo de nivel tarjeta
API | Descripción |
|---|---|
POST /account/details | Obtención de códigos actuales que tiene el cliente de nivel cuenta. |
POST cards/embosser/details | Obtención de códigos actuales que tiene el cliente de nivel tarjeta. |
POST /cards/embosser/details | Obtención de detalle de tarjeta para validar que la tarjeta esté activa y no esté ya bloqueada. |
PUT cards/embosser/block | Eliminar bloqueo de tarjeta. |
Peer to Peer P2P / Pago de solicitud de dinero
API | Descripción |
|---|---|
POST /account/details | Obtención de códigos de bloqueo para validar que el usuario que envía el dinero esté autorizado para enviar P2P. |
POST /account/details | Obtención de códigos de bloqueo para validar que el usuario receptor esté autorizado para recibir P2P. |
POST account/balance/details | Obtener el saldo del usuario que envía para validar que le alcance. |
POST account/balance/details | Obtener el saldo del usuario receptor y validar sus límites de cuenta. |
PUT account/FL-transferP2P. | Ejecución de la transacción. |