Client integration

The client is managed by a script that opens a dialog for either onboarding a new customer or logging in an existing one. The action is determined by the scope parameter in the authorization request URL. All failed or unsuccessful scenarios are handled within the dialog, and the user is informed accordingly. The authorize method will only throw errors in unexpected cases, such as network issues.

Authorize a customer

After a user clicks Login or Sign up in your UI, call the following method, which our script tag has placed on the window object:

window.ledyer.access.api.authorize(requestUrl);

Here is a basic example of what an implementation might look like:

const handleProceedWithLedyer = async (authCodeUrl) => {
	try {
		const authResponse = await window.ledyer.access.api.authorize(authCodeUrl);

		// ... some time will pass while the user is interacting with the dialog

		if (authResponse) {
			// if a user successfully logs in or signs up, the authResponse will contain
			// state and code properties.
			const { state, code } = authResponse;
			// You may now send this to your backend, make sure to verify the state parameter with your oauth2 library,
			// and then send the code to Ledyer BE in exchange for an access token
			// redirect the user to a success page
		}
	} catch (error) {
		// errors such as unauthorized during onboarding is handled in the ledyer dialog and the user is informed.
		// This catch block is for unexpected errors.
	}
};

<button onclick="handleProceedWithLedyer(authCodeUrl)">Login</button>

Once you have verified state you maybe proceed to the next and final step.