A continuación, describimos los endpoints que contiene cada servicio desarrollado para Mirror Strategy:
Note |
---|
IMPORTANTE: El servicio de Aggregation es el que se usarán para las pruebas correspondientes en ambientes de QA y ST en Genesys |
Detalle de endpoints
Table of Contents | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Ejemplo body:
El detalle que se muestra es el camino deseado (happy path) de los endpoints desarrollados.
El código esperado es un 200 + un body, en estos casos
Ejemplo de body - EnableToken (POST /tokens/key):
Body - Request
{
"deviceId": "15703c1c-352a-11ee-be56-0242ac120002",
"keyId": "05616256-352a-11ee-be56-0242ac120002",
"publicKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCR9+qdg/HrRLzgkbphCnQpN+NscOEY8vQO/M+/U4erX3ZK9IcV9MulLyY4faIBV2LeJpeUDzemFygjz/e+as6gKjbrJ7jHldl0stpfyUv6Se5iwC2wunevURLjnyk31Af9QtJr5KGsNrtyVzNYis92LGUY64tHEVNoL6DmrD/JJwIDAQAB",
"publicKeyAlgorithm": "RSA"
}
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Body - Response { "seed": "PGh9l4M6kfEWQPSAlB2ELD9p1GTMZ/lQSzkBg2n/lhTOsZtNh2lvhoRkCCBnsGuZgjBGPIfHFye3yi/b5YUKl+2CA673Fg66WruKTU58ywk/rZYUKXOku2NI8PliZG9P9/nrgrZ75D5SxsuUv0DIj8A0WfdYu16PLFnH4MGhD6A=" } |
Mirror
Account
Info |
---|
Consulta de bloqueos Repositorio sincronizado con Fiserv Disminuye peticiones al Proveedor |
GetAccountDetails
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza la consulta de bloqueos de cuenta. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
SetAccountBlock
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza bloqueos/desbloqueo de cuenta. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
SynchronizeMirrorAccount
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Sincroniza el mirror de account con la información de Fiserv. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
Balance
Info |
---|
Consulta de balance Repositorio sincronizado con Fiserv Disminuye peticiones al Proveedor |
GetAccountBalance
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza la consulta de balance de cuenta. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
SynchronizeMirrorBalance
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Sincroniza el mirror de balance con la información de Fiserv. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
TransferBalance
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia . |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
TransferPeerToPeer
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia P2P. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
FrozenBalanceTransfer
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia QR. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
Card
Info |
---|
Incorpora los endpoints de Card Mirror Sincronización de datos con el Mirror Expone endpoints a través de un API REST |
POST → /v1/cards/embossers/details
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Obtener cuenta mediante Pantoken |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT → /v1/cards/embossers/block
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Bloqueo de tarjetas |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
Gateway
Account Adapter
Info |
---|
Permite tener la comunicación entre Spin y Fiserv para los módulos de account y balance. |
GetAccountDetails
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza la consulta de bloqueos de cuenta. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
SetAccountBlock
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza bloqueos/desbloqueo de cuenta. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
TransferBalance
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia . |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
TransferPeerToPeer
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia P2P. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
FrozenBalanceTransfer
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia QR. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
GetAccountBalance
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza la consulta de balance de cuenta. |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
Customer Adapter
Info |
---|
Permite tener la comunicación entre Spin y Fiserv para los módulos de customer. Este componente se desarrolló para desacoplar los procesos core de Spin y el proveedor financiero para lograr una mayor escalabilidad. |
CreateCustomer
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Creación del cliente |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
UpdateCustomer
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Actualizar cliente |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
LinkAccountToCustomer
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Vincular cuenta al cliente |
|
| 2 OK: Solicitud exitosa. 4 Bad Request: Request con campos no válidos. 5 Internal Server Error: Servicios no disponibles. |
Card Gateway
Info |
---|
Permite tener la comunicación entre Spin y Fiserv para los módulos de card. |
POST → /v1/cards/embosser
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
|
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
POST → /v1/cards/embosser/details
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Obtener cuenta mediante Pantoken |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
POST → /v1/cards/embosser/block
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Bloqueo de tarjetas |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
Aggregation
Estos son los componentes que se estarán usando para la ejecución de pruebas en el proyecto:
Account Aggregation Service
Info |
---|
Incorpora los servicios de Account Mirror y Balance Mirror Validación de campos mandatorios antes del envío a Fiserv Expone endpoints a través de un API REST y gRPC |
POST → /v1/accounts/details
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza la consulta de bloqueos de cuenta. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
POST → /v1/accounts/blocks
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza bloqueos/desbloqueo de cuenta. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
POST → /v1/accounts/syncs
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Sincroniza el mirror de account con la información de Fiserv. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles.POST → /v1/balances |
POST → /v1/balances
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza la consulta de balance de cuenta. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
POST → /v1/balances/syncs
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Sincroniza el mirror de balance con la información de Fiserv. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT → /v1/balances/transfers
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia . |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT → /v1/balances/transfers-p2p
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia P2P. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT → /v1/balances/transfers-qr
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Realiza una transferencia QR. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
Customer Aggregation service
Info |
---|
Incorpora los endpoints de Customer Validación de campos mandatorios antes del envío a Fiserv Expone endpoints a través de un API REST y gRPC |
POST → /customers
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Registro del cliente en la el proveedor de clientes. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT → /customers
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Actualización de los datos del cliente en el proveedor de clientes. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
POST → /customers/account
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Vinculación del cliente en la cuenta de Spin. |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
Card Aggregation service
Info |
---|
Incorpora los endpoints de Card Validación de campos mandatorios antes del envío a Fiserv Expone endpoints a través de un API REST y gRPC |
POST /cards/embosser/details
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Obtener cuenta mediante Pantoken |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT /account/prepaid
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Vinculación de tarjetas a cuenta |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
POST /cards/account
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Recuperación del numero de cuenta |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT /cards/activation
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Activación de tarjetas |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT /cards/embosser/block
Descripción | Request | Response | HTTP Codes | ||||
---|---|---|---|---|---|---|---|
Bloqueo de tarjetas |
|
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |