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 key.
You receive an access_token.

📖

Create access token

Open Recipe

API Reference – Create access token

Important

For security, access tokens are valid for 1 hour only.
If your token expires, make 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.

📖

Create Bank Account Verification workflow

Open Recipe

API Reference – Create workflow

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.

📖

Create App Drop-in SDK session

Open Recipe

API Reference – Create SDK session

Important

• SDK validation codes are single use and expire after 2 hours.
• If the client stops in the middle of the workflow, you need to create a new SDK session.
• When the client closes the app, the validationCode is invalidated and cleared from the cache.

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

Status	Description	Action
`pending`	The reference payment is being processed.	Wait for `completed` status.
`kyc_required`	• The client's Identity Verification case was unsuccessful. or • There is no Identity Verification case for this client.	Create a new workflow that includes `IDV` and `BAV`.
`completed`	The reference payment was successfully processed.
`failed`	The reference payment failed. For the specific reason, check the accompanying status code.	Create a new workflow for `BAV` only.

4. Check reference payment status

Check the reference payment status:

📖

Get reference payment status

Open Recipe

API Reference – Get reference payment status

Success

You have integrated Bank Account Verification for your app!

Top of page