Bank Account Verification Integration

App Drop-in guide

This guide provides step-by-step instructions on how to integrate Bank Account Verification with the App Drop-in.

Before you begin, make sure you have completed the following:

• App Drop-in Setup with your chosen SDK
• App UI Customization
• Bank Account Verification Setup

---

Flow

Click to magnify.

---

1. Authenticate

Create an access token to authenticate in our API:

• You provide your Fourthline API credentials.
• You receive an access_token.

Important

For security, access tokens are valid for 1 hour only.

If your token expires, create a new access token by making another Create access token request.

---

2. Create workflow

Create a Bank Account Verification workflow:

• You specify the workflowName and provide your unique identifier for the client.
• You receive a workflowId and a Fourthline clientId.

Status: The reference payment status changes to new.

---

3. Create SDK session

Create the App Drop-in session:

• You provide the workflowId.
• You receive a validationCode to pass to the SDK in your backend.

Important

• SDK validation codes are single-use and expire after 2 hours.
• If the client stops partway through the workflow, create a new SDK session.
• When the client closes the app, the validationCode is invalidated and removed from the cache.

Status: The payment status changes to one of the following and we send the relevant webhook notification:

---

4. Check reference payment status

Check the reference payment status.