En esta sección se encuentran los campos mandatorios y el formato a validar en el Account Aggregation Service, en cada request por cada endpoint.


Template para mensajes de validación:

Campo requerido

{fieldName} is required

Longitud del campo

{fieldName} must be between {min} and {max} characters long {fieldName} must be {n} characters long
{fieldName} must be 1 character long

Rangos enteros permitidos

{fieldName} must be at least {value} {fieldName} must be at most {value}

Expresión regular (fechas, email)

{fieldName} must be valid, expected format: {regular expression or suggested format}

Ejemplo de respuesta con error en validación REST Controller

1{ 2 "message": "Invalid requests", 3 "code": "INVALID_PARAMETERS", 4 "description": "Invalid requests", 5 "args": [ 6 { 7 "arg": "REASON", 8 "value": "accountNumber must be 19 characters long" 9 } 10 ], 11 "status": "400 BAD_REQUEST" 12}


1{ 2 "message": "Invalid requests", 3 "code": "INVALID_PARAMETERS", 4 "description": "Invalid requests", 5 "args": [ 6 { 7 "arg": "REASON", 8 "value": "blockCodeIndicator is required|foreignUse must be at most 1|functionCode must be 1 charac 9 } 10 ], 11 "status": "400 BAD_REQUEST" 12}

gRPC


Endpoints

Block Code

Endpoint

POST /v1/accounts/blocks

Fiserv Endpoint

PUT /account/block-code

Request Schema

Campo

Formato

accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

functionCode

string

mandatory

minLength: 0

maxLength: 1

example: B enum: U, B

blockCodeIndicator

integer

mandatory

example: 1

Min Length = 1

Max Length = 1

Values:

0 = Tests both block code 1 and 2 to determine and use the one that fits best relative to priority settings (not allowed for unblock)

1 = Block code 1

2 = Block code 2

foreignUse

string

mandatory

minLength: 0

maxLength: 1

example: 0

Values: 0

1

Account Details / Sync

Endpoint

POST /v1/accounts/details
POST /v1/accounts/syncs

Fiserv Endpoint

/account/details

Request Schema

Campo

Formato

accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

Transfer Peer to Peer

Endpoint

PUT /v1/balances/transfers-p2p

Fiserv Endpoint

PUT/account/FL-transferP2P

Request Schema

Campo

Formato

to.accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

to.actionCode

String

mandatory

minLenght=4

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

from.accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

from.actionCode

String

mandatory

minLenght=4

maxLength=4

example=8008

transactionAmount

Long

mandatory

xTransactionId

String

mandatory

effectiveDate

String

mandatory

YYYY-MM-DD

Account Balance / Sync POST

Endpoints

POST /v1/balances
POST /v1/balances/syncs

Fiserv Endpoint

POST /account/balance/details

Request Schema

Campo

Formato

accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

Transfer Balance

Endpoint

PUT /v1/balances/transfers

Fiserv Endpoint

PUT /account/FL-balance

Request Schema

Campo

Formato

accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

xTransactionId

string

mandatory

operationType

string

mandatory

Values: “D”: Deposit, “W“:Withdrawal

ransactionData.transactionAmount

mandatory

transactionData.actionCode

mandatory

transactionData.effectiveDate

mandatory

transactionData.description

mandatory

transactionData.paidConcept

mandatory

transactionData.n1n2ByPass

mandatory

transactionData.identifier

mandatory

transactionData.box

mandatory

transactionData.crPlaza

mandatory

transactionData.crStore

mandatory

transactionData.keyTracking

mandatory

transactionData.beneficiaryAccount

mandatory

transactionData.senderAccount

mandatory

transactionData.counterpartInstitution

mandatory

transactionData.operatingInstitution

mandatory

ransactionData.frcUprkBeneficiary

mandatory

transactionData.orderingFrcUprk

mandatory

transactionData.device

mandatory

transactionData.ip

mandatory

transactionData.latitude

mandatory

transactionData.longitude

mandatory

transactionData.recipientName

mandatory

transactionData.orderingName

mandatory

transactionData.paymentSourceId X-

mandatory

Transaction-ID memoPostedIndicator

mandatory

suppressMonetaryTransaction

mandatory

Frozen Balance

Endpoint

PUT /v1/balances/transfers-qr

Fiserv Endpoint

PUT /account/QR-balance


Request Schema

Campo

Formato

accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

Pre Auth

Endpoint

POST /v1/accounts/preauth

Fiserv Endpoint

POST /account/organizationNumber/level-limits/validate-amount

Request Schema

Campo

Formato

accountNumber

string

mandatory

minLength: 19

maxLength: 19

example: 1234567891234567891

action

string

mandatory

minLength: 1

maxLength: 1

operation

string

mandatory

minLength: 1

maxLength: 1

logo

string

mandatory

numeric regular expression

transactionAmount

long

mandatory

must be at least 0