ormuz
Home/Integrations/Bridge/Nodes/Retrieve item (Bridge)
BridgeConnecteurStable

Retrieve item (Bridge)

Rereads the current state of a specific Bridge bank connection.

Vue d’ensemble

Retrieve Bridge item rereads a specific bank connection to obtain its current state and refresh information.

It is especially useful after a Bridge event concerning an item or before deciding that user reconnection is required.

Process example

User Bridge + Item Bridge
Récupérer une connexion bancaire (Bridge)
Item Bridge

Exemple simplifié d’utilisation de Récupérer une connexion bancaire (Bridge) dans un processus Ormuz.

Data resolution

The node applies the following rules from the supplied objects and filters.

DataSource or rule
Retrieved itemitem.id.
StateStatus and status information exposed by Bridge.
Authentificationauthentication_expires_at when an expiration date is available.
RefreshRefresh state and dates present on the Bridge object.

Parameters 3

Contexte principal

Objects and configuration that determine the Bridge operation.

extension_config_idRequisref(extension_config:bridge)
Active Bridge configuration used for this operation. It determines the Bridge API credentials and environment; the merchant remains the merchant of the current process.
bridge_userRequisBridge user
Bridge user representing the person whose bank accounts must be connected, accessed, or verified. Usually obtain it with bridge.ensure_user rather than constructing the object manually.
itemRequisBridge item
Bridge bank connection (item) to retrieve or use as a filter. An item represents a user's relationship with a financial institution and may contain multiple accounts.

Outputs 1

Banking data

Bank-aggregation or verification objects available to subsequent steps.

itemBridge item
Bridge bank connection reread in its current state.

Behavior

Identify the connection

The node uses the identifier of the received item.

Relire Bridge

The current state of the bank connection is retrieved for this user.

Exposer l’item

The refreshed object can be used to decide whether to continue, refresh, or request reconnection.

Limits and responsibilities

  • Rereading an item does not trigger new user bank authentication.
  • The node does not return accounts or transactions directly; use the dedicated list nodes.

Troubleshooting

Item not usable

Inspect its status and authentication information; if the user must act, open a bank-management session.