Introduction
Link is Lean’s official SDK that leverages the capabilities of modern browsers and mobile clients, such as asynchronous communication, encryption at REST, transit and much more, while giving you an optimised, customizable, conversion-optimized user journey for your users to connect their accounts.
Link SDK
To integrate Lean’s Link SDK, you first need to add the SDK to your frontend by importing it as follows:
html
<script src="https://cdn.leantech.me/link/sdk/web/latest/Lean.min.js" />
You will then need to include the following div within your body:
html
<div id="lean-link"></div>
This will enable you to call Lean globally in your application.
Available Methods
.link()
The .link method is used to connect accounts with the Data API.
.reconnect()
The .reconnect method is used to reauthenticate a customer account with the Data API.
.createPaymentSource()
The .createPaymentSource method is used to connect a bank account as a payment method to your application in the Payments API.
.updatePaymentSource()
The .updatePaymentSource method is used to authorize an additional payment destination for an existing payment source in the Payments API.
.pay()
The .pay method is used to make a bank to bank transfer from your customer's account to your account in the Payments API.
Was this section helpful?
javascript
Lean.link({app_token: "2c9a80897169b1dd01716a0339e30003",permissions: ["identity", "accounts", "transactions", "balance"],customer_id: "d57a03bc-ef9d-460b-8fa6-3b17e425326c",sandbox: "true",});
javascript
Lean.reconnect({app_token: "2c9a80897169b1dd01716a0339e30003",reconnect_id: "e9521dc4-adc6-4c09-9994-f8b13f28db85",sandbox: "true",});
javascript
Lean.createPaymentSource({app_token: "2c9a80897169b1dd01716a0339e30003",customer_id: "d57a03bc-ef9d-460b-8fa6-3b17e425326c",sandbox: "true",});
javascript
Lean.updatePaymentSource({app_token: "2c9a80897169b1dd01716a0339e30003",customer_id: "d57a03bc-ef9d-460b-8fa6-3b17e425326c",payment_source_id: "88d7aefe-aae6-4eb3-a314-6e60e73fda35",payment_destination_id: "f8d6fe12-5cc3-4df2-82c2-48b4dd6f74a7",sandbox: "true",});
javascript
Lean.pay({app_token: "2c9a80897169b1dd01716a0339e30003",payment_intent_id: "452bcde4-5e48-44bb-8f6d-40c5c286466b"sandbox: "true",});
Webhook URL
Results from the Link SDK will be sent to your server via a POST request from Lean made to the Webhook URL in the application settings.
Response
type String
The type of the webhook being received in the format of: [Object type].[action]. When triggered by the Lean.link() call, the type will be entity.created.
message String
Description of the event that has triggered the webhook.
payload Object
The resource which has triggered the webhook.
Upon entity creation, this will be the entity object:
View child attributes
id String
The identifier you will use to reference your customer's bank entity when making API calls.
app_user_id String
For your convenience, we’ll also pass the id your application uses to reference your customer.
permissions Array
The permissions your customer granted you.
bank_details Object
Attributes related to the bank that the entity originates from.
View child attributes
name String
The name of the bank where your user's entity and accounts exist.
bank_identifier String
For use with the /bank endpoint, allows you to query data on the bank related to the entity.
logo_url String
A URL pointing to an image of the bank's logo.
main_color String
The HEX value of the primary color the bank uses for display purposes.
background_color String
The HEX value of the secondary color the bank uses for display purposes.
timestamp DateTime
The time at which the webhook was triggered.
json
// Success Example{"type": "entity.created","message": "An entity object has been created.","payload": {"id": "f08fb010-878f-407a-9ac2-a7840fb56185","app_user_id": "00001","permissions": ["transactions", "balance", "identity", "accounts"],"bank_details": {"name": "Lean Mockbank","identifier": "LEANMB1_SAU","logo": "https://cdn.leantech.me/img/banks/white-lean.png","main_color": "#1beb75","background_color": "#001E26"}},"timestamp": "2020-10-10T17:19:00.059933Z"}
Callback functions
The Web SDK takes an optional parameter for callback which allows you to recieve events on SDK close, completion or error. The object returned to your callback function is in the following format:
{ status: 'SUCCESS', message: 'entity connected' }
Status'
SUCCESS - The flow initialized was completed successfully
CLOSED - The user exited the flow, the step will be provided in the message parameter.
ERROR - The SDK or user experienced an error - the details for the error are available in the message.
javascript
function myCallback(status) {console.log(status)// insert actions you want to perform on SDK close}connectButton.addEventListener("click", function() {Lean.link({app_token: "YOUR_APP_ID",permissions: ["identity", "accounts", "transactions", "balance"],customer_id: customerId.value,sandbox: "false",callback: myCallback});})
Skip Bank List
In some use cases you may want to provide your own UI for the bank selection screen in the LinkSDK. This can be achieved by passing in a bank_identifier during the .link() and .createPaymentSource flows.
You can get a list of available bank_identifiers for your application by making a call to the /banks/ endpoint.
bash
curl -X GET 'https://api.leantech.me/banks/v1/' \--header 'lean-app-token: 2c9a80897169b1dd01716a0339e30003'
json
// example response[{"id": 13,"identifier": "FAB_UAE","name": "First Abu Dhabi Bank","main_color": "#ffffff","background_color": "#00458A","theme": "light","country_code": "UAE","active": true,"traits": ["user-input-on-login","auth-credentials"],"supported_account_types": ["CREDIT","SAVINGS","CURRENT"]},{"id": 12,"identifier": "ENBD_UAE","name": "Emirates NBD","main_color": "#FDB813","background_color": "#06357A","theme": "light","country_code": "UAE","active": true,"traits": ["auth-credentials"],"supported_account_types": ["CREDIT","SAVINGS","CURRENT"]}
javascript
Lean.link({app_token: "2c9a80897169b1dd01716a0339e30003",permissions: ["identity", "accounts", "transactions", "balance"],customer_id: "552e8102b3c14401a36ac14fadab94de",sandbox: "true",bank_identifier: "ENBD_UAE"});
javascript
Lean.createPaymentSource({app_token: "2c9a80897169b1dd01716a0339e30003",customer_id: "552e8102b3c14401a36ac14fadab94de",sandbox: "true",bank_identifier: "ENBD_UAE"});
Skip Payment Source selection
In Some use cases, you may want to render your own list of Payment Sources - or have business logic around which payment source can be used to make a specific payment. In these cases, you can pass the accounts[n].id parameter from a Customer's Payment Source into the LinkSDK to skip the selection screen within the SDK.
json
// Payment Source - available from /customers/v1/{customer_id}/payment-sources{"id": "0cb405e4-dbda-4420-9421-5202111934cb","customer_id": "79ed9723-f409-4b21-b7b6-8678be94383d","app_id": "40289089716ab818017178bc1cff0005","bank_identifier": "HSBC_UAE","status": "ACTIVE","beneficiary_cool_off_expiry": null,"accounts": [{"id": "ec02035e-bff8-4ada-832e-c3a71105ba48","account_id": "c6d2121b-7e3a-4ce0-9f47-905497a23b2d","account_name": "CURRENT ACCOUNT","account_number": "030-798508-001","iban": "AE870200000030798508001","balance": 465.38,"currency": "AED","balance_last_updated": "2021-03-01T17:07:30.172853Z"}]},
javascript
Lean.pay({app_token: "2c9a80897169b1dd01716a0339e30003",payment_intent_id: "452bcde4-5e48-44bb-8f6d-40c5c286466b"sandbox: "true",account_id: "ec02035e-bff8-4ada-832e-c3a71105ba48"});
Next Steps
With the Link SDK installed in your application, you can now get entity_ids for the Data API and create payment sources and charges with the Payment API.
Payments API Reference →