Definición de servicios - Mirror Strategy
- Ángeles Díaz (Unlicensed)
- Héctor Villa (Unlicensed)
- Judith Medina Ruiz (Unlicensed)
A continuación, describimos los endpoints que contiene cada servicio desarrollado para Mirror Strategy:
IMPORTANTE:
El servicio de Aggregation es el que se usarán para las pruebas correspondientes en ambientes de QA y ST:
Account + Customer en Genesys
Card en Spin
Detalle de endpoints
- 1 Aggregation
- 2 Mirror
- 2.1 Account
- 2.1.1 GetAccountDetails
- 2.1.2 SetAccountBlock
- 2.1.3 SynchronizeMirrorAccount
- 2.2 Balance
- 2.2.1 GetAccountBalance
- 2.2.2 SynchronizeMirrorBalance
- 2.2.3 TransferBalance
- 2.2.4 TransferPeerToPeer
- 2.2.5 FrozenBalanceTransfer
- 2.3 Card
- 2.1 Account
- 3 Gateway
- 3.1 Account Adapter
- 3.1.1 GetAccountDetails
- 3.1.2 SetAccountBlock
- 3.1.3 TransferBalance
- 3.1.4 TransferPeerToPeer
- 3.1.5 FrozenBalanceTransfer
- 3.1.6 GetAccountBalance
- 3.2 Customer Adapter
- 3.2.1 CreateCustomer
- 3.2.2 UpdateCustomer
- 3.2.3 LinkAccountToCustomer
- 3.3 Card Gateway
- 3.1 Account Adapter
Aggregation
Estos son los componentes que se estarán usando para la ejecución de pruebas en el proyecto:
Account Aggregation Service
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 | GRPC Codes |
|---|---|---|---|---|
Realiza la consulta de bloqueos de cuenta Activa | {
"accountNumber": "9500507060523627372"
} | {
"accountData": {
"accountNumber": "9500507060523627372",
"customerNumber": "0995000000000078206"
}
}
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Realiza la consulta de bloqueos de cuenta Inactiva | {
"accountNumber": "9500501403742215502"
} | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | |
Realiza la consulta de bloqueos de cuenta Expirada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Realiza la consulta de bloqueos de cuenta Bloqueada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
POST → /v1/accounts/blocks
Descripción | Request | Response | HTTP Codes | GRPC Codes |
|---|---|---|---|---|
Realiza bloqueos/desbloqueo de cuenta - Bloquear (foreignUse= 0) |
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | |
Realiza bloqueos/desbloqueo de cuenta - Bloquear (foreignUse= 1) | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Realiza bloqueos/desbloqueo de cuenta - Desbloquear |
| 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Para éste endpoint se requieren los siguientes valores:
blockCode: Código de bloqueo proporcionado por Spin.
blockCodeIndicator: Indica el código de bloqueo a usar: 0-1 primer código de bloqueo, 2 segundo código de bloqueo.
foreignUse: 0
functionCode: indica si se va bloquear (“B“) o desbloquear (“U“)
accountNumber: código de cuenta.
POST → /v1/accounts/syncs
Descripción | Request | Response | HTTP Codes | GRPC Codes |
|---|---|---|---|---|
Sincroniza el mirror de account con la información de Fiserv - Número de cuenta Activa | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles.POST → /v1/balances | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Sincroniza el mirror de account con la información de Fiserv - Número de cuenta Inactiva | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles.POST → /v1/balances | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Sincroniza el mirror de account con la información de Fiserv - Número de cuenta Expirada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles.POST → /v1/balances | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Sincroniza el mirror de account con la información de Fiserv - Número de cuenta Bloqueada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles.POST → /v1/balances | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
POST → /v1/balances
Descripción | Request | Response | HTTP Codes | GRPC 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. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
POST → /v1/balances/syncs
Descripción | Request | Response | HTTP Codes | GRPC Codes |
|---|---|---|---|---|
Sincroniza el mirror de balance con la información de Fiserv - Número de cuenta Activa | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Sincroniza el mirror de balance con la información de Fiserv - Número de cuenta Inactiva | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Sincroniza el mirror de balance con la información de Fiserv - Número de cuenta Expirada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Sincroniza el mirror de balance con la información de Fiserv - Número de cuenta Bloqueada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
PUT → /v1/balances/transfers
Descripción | Request | Response | HTTP Codes | GRPC Codes |
|---|---|---|---|---|
Realiza una transferencia - Número de cuenta Activa | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Realiza una transferencia - Número de cuenta Inactiva | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Realiza una transferencia - Número de cuenta Expirada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. | ||
Realiza una transferencia - Número de cuenta Bloqueada | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
PUT → /v1/balances/transfers-p2p
Descripción | Request | Response | HTTP Codes | GRPC 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. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
PUT → /v1/balances/transfers-qr
Descripción | Request | Response | HTTP Codes | GRPC 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. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Customer Aggregation service
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 | GRPC 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. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
PUT → /customers
Descripción | Request | Response | HTTP Codes | GRPC 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. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
POST → /customers/account
Descripción | Request | Response | HTTP Codes | GRPC 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. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Card Aggregation service
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 /cards/account
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 [Equipo de Spin]
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. |
Mirror
Account
GetAccountDetails
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza la consulta de bloqueos de cuenta. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
SetAccountBlock
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza bloqueos/desbloqueo de cuenta. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
SynchronizeMirrorAccount
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Sincroniza el mirror de account con la información de Fiserv. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Balance
GetAccountBalance
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza la consulta de balance de cuenta. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
SynchronizeMirrorBalance
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Sincroniza el mirror de balance con la información de Fiserv. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
TransferBalance
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza una transferencia . | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
TransferPeerToPeer
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza una transferencia P2P. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
FrozenBalanceTransfer
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza una transferencia QR. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Card
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
GetAccountDetails
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza la consulta de bloqueos de cuenta. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
SetAccountBlock
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza bloqueos/desbloqueo de cuenta. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
TransferBalance
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza una transferencia . | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
TransferPeerToPeer
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza una transferencia P2P. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
FrozenBalanceTransfer
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza una transferencia QR. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
GetAccountBalance
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Realiza la consulta de balance de cuenta. | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Customer Adapter
CreateCustomer
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Creación del cliente | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
UpdateCustomer
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Actualizar cliente | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
LinkAccountToCustomer
Descripción | Request | Response | GRPC Codes |
|---|---|---|---|
Vincular cuenta al cliente | 0 OK: Solicitud exitosa. 3 Bad Request: Request con campos no válidos. 13 Internal Server Error: Servicios no disponibles. |
Card Gateway
POST → /cards/account
Descripción | Request | Response | HTTP Codes |
|---|---|---|---|
Vincular una tarjeta con un número de cuenta | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |
PUT → /cards/account
Descripción | Request | Response | HTTP Codes |
|---|---|---|---|
Desvincular una tarjeta de un número de cuenta | 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 Activo | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | ||
Obtener cuenta mediante Pantoken Inactivo | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | ||
Obtener cuenta mediante Pantoken Expirado | 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 - Bloqueo | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. | ||
Bloqueo de tarjetas - Desbloqueo | 200: Solicitud exitosa. 400: Request con campos no válidos. 401: Apy Key no válida. 500: Servicios no disponibles. |