Skip to main content
POST
Validate a receiving account synchronously

Authorizations

Authorization
string
header
required

JWT Bearer token authentication. Obtain token from /v1/login/oauth/access_token endpoint using client credentials (clientId and clientSecret).

Include token in Authorization header: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token expires after 3600 seconds (1 hour).

Body

application/json
dtHrOp
string
required

Operation timestamp (ISO-8601).

pagador
object
required
recebedor
object
required
valor
number<double>
required

Amount in reais (a JSON number).

bankIdPss
string

Saque/troco PSS participant ISPB (a v5.5.0 string).

creditoDevolucao
object
creditoOrdemPagamento
object
finalidade
integer<int64>

Finality (eFinality).

idConciliacaoRecebedor
string

Recipient conciliation id.

infEntreClientes
string

Free-text inter-client info.

modalidadeAgente
integer<int64>

Agent modality (eModalityAgent).

prioridadePagamento
integer<int64>

Payment priority.

tpIniciacao
integer<int64>

Initiation type (eStartupType).

tpPrioridadePagamento
integer<int64>

Payment priority type.

vlrDetalhe
object[] | null

Optional value-detail entries.

Response

OK

dtHrValidacao
string
required

Validation timestamp (ISO-8601, UTC).

resultado
integer<int64>
required

Validation result (0=Inválido, 1=Válido).

motivo
string

Reason code on an invalid result (BE17/AC03/BE01).

motivoComplemento
string

Human-readable reason complement on an invalid result.