Bridge API Documentation

Bridge Documentation

Welcome to our API documentation!

We're happy to share with you our new API 2021 version! Please check our Product Changelog to know the main changes.

You'll find comprehensive guides and documentation to help you start working with Bridge as quickly as possible, as well as support if you get stuck.

Let's jump right in!

Get Started

#2 - Bridge Pay

Security and settings

  • Have you set up the IP whitelisting on your Bridge applications ?

  • Have you set up the callbacks, the highlighted banks and your logo ?

  • Do you encrypt all the banking data you are fetching ?

  • Do you generate randomly the passwords of your Bridge users ?

  • Have you set up a production date with our Sales team ?

Bridge users

  • Do you store the Bridge users (uuid, email, password) in a table linked to your own users' table ?
  • Do you authenticate each Bridge user before call our API ?
  • Do you delete the Bridge users when your customers cancel their subscription to your services ?

Item lifecycle

  • When leaving the Bridge Connect, do you retrieve the uuid, item_id, success, step and optionnally the context parameters from the redirection url in order to adapt your journey to the customer case ?

  • When leaving the Bridge Connect, do you retrieve the item's status to identify the connection status and manage potential errors ?

  • Do you interpret the item statuses everyday and before fetching banking data from our API ?
    *Do you display the status_code_description to your customers to inform them of the situation ? You can modify the Accept-Language header to FR to retrieve them in French.

  • In the case of an item with the 1010 status, do you ask your customer to validate a Strong Customer Authentication thanks to the Bridge Connect ? Manage SCA and Sync

  • In the case of an item with the 1003 status, if it does not return to a functional state (0 status) after 48 hours, do you send a request to Bridge support ?

  • In the case of an item with the 1100 status, do you ask your customer to validate his business accounts thanks to the Bridge Connect ? Validate pro items

  • In the case of an item with the 402 status, do you ask your customer to update his banking credentials thanks to the Bridge Connect because they are incorrect ? Edit an item

Transfer journey

  • Do you manage the item statuses above before redirecting the customer to the Bridge Pay ?

  • Do you interpret the capabilities resource of the items bank to know the single_transfer / bulk_transfer coverage of your customer's bank ?

  • When leaving the Bridge Pay, do you retrieve the user_uuid, success, step, reference and bulk_id (only for the bulk payments) parameters from the redirection url in order to adapt your journey to the customer case ?

Updated 6 months ago

#2 - Bridge Pay


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.