Initiate connectivity (ECO) test
Prerequisite: an active certificate (see rotateCertificate, activateCertificate) and a READY readiness report (see getReadiness) before the connectivity test; a passing connectivity test is itself the prerequisite for a submit operation (see createBankTransferOperation). Builds a GEN0001 echo request addressed to the given participant, persists it as SUBMITTED before rail dispatch, and lets the outbound relay dispatch it to the RSFN. The counterparty answers with GEN0001R1 echoing the message back; the response correlates by NUOp and confirms the test. Idempotent — replaying the same X-Idempotency key with the same body returns the cached response.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Idempotency key (primary).
Idempotency key (legacy alias for X-Idempotency).
Idempotency key TTL in seconds (overrides the configured default).
Body
Response
Created
IF control number assigned to the GEN0001 submission.
"20260610000001"
STR message code of the submission (always GEN0001 for connectivity tests).
"GEN0001"
BACEN protocol identifier (NUOp) assigned to the GEN0001 connectivity-test submission.
"12345678202606100000001"
Submission status; SUBMITTED until the counterparty's GEN0001R1 echo correlates by NUOp and flips it to CONFIRMED.
"SUBMITTED"
RFC3339 UTC timestamp when the submission was persisted before send.
"2026-06-10T12:00:00Z"

