White-Label App
Overview
White-Label App is the fastest and easiest way for software companies to launch branded financial features, with one line of code. Companies can now offer customers a branded banking and lending experience, while reducing engineering lift and radically accelerating time to market.
White-Label App is a turnkey solution for companies to embed accounts, cards, payments, and lending, directly in their product. This for example, can be done through the addition of a banking tab within a client’s web app.
White-Label App is a fully-featured web app that encapsulates backend code, frontend UI/UX design, optimal user experience, security, and compliance.
In addition to a complete set of features, optimal user experiences are already built in, including initial account funding, card activation, activity filtering, and payment workflows – so you can easily activate and retain banking and lending customers.
Supported Use Cases
The current version of the White Label App supports banking for consumers.
Is the White Label App Right for me?
I have restricted resources (R&D, product, design etc.)
I want to test the market opportunity before investing my own resources
I'm looking for the fastest way to get market with an MVP
I see an opportunity to monetize an existing customer base by leveraging embedded finance
Requirements for V1
I have a prominent web-based and mobile product
I can provide a JWT to Mansar (a token that tells Mansar the unique identity of the user, and allows Mansar to verify that they are currently logged into your app)
Supported Platforms
Web & Generic Mobile App (desktop & mobile)
Available
React Native
Q3 '24
iOS
Q3 '24
Android
Q3 '24
Features
Onboarding (KYB / KYC) experience
Identity verification, fraud screening, document verification (if applicable), manual reviews
Deposit Accounts
Multiple deposit accounts with flexible terms (limits, clearing times, end customer fees, interest)
Account funding
Mobile wallet debit (pull)
Money In
Receive mobile wallet credit, Receive Wire, Cash deposits in Allpoint ATMs (using a physical card)
Money Out
Mobile wallet credit (same / next day), Book payments (between accounts on the Mansar platform), cards, ATM
Activity
Overview of the customer's activity (transactions, card authorizations etc.)
Cards
Multiple physical and/or virtual cards, both branded. Including ability to add cards to a mobile wallet.
First-time user experience
A a part of the onboarding flow, the White-label App includes a tutorial step to encourage the end-user to fund the account and activating the available card, as a call to action and engagement with the banking features
Embedding
Authentication Setup
White-label app requires a JWT token to be passed to it. This token is used to authenticate the end-user. The token is passed to the app via the jwt-token attribute.
Using Identity Providers
Mansar supports JWT token generated by the following Identity Providers: Okta, Auth0, AWS Cognito, Stych. If you are using one of these providers, you should provide Mansar with JWKs Path and JWT Issuer. Mansar will use this information to validate the JWT token.
Custom JWT implementation
Mansar can rely on a custom implementation of JWT token that adheres to the specifications outlined in RFC 7519. In this case, you should provide Mansar with a public key that will be used to validate the token. The token must be signed using the RS256 algorithm and must include the following claims:
sub: a unique identifier for the end-user.exp: the expiration time of the token.iss: the issuer of the token.
Implementation
Embedding the white-label app is accomplished by adding a script tag and a mansar-elements-white-label-app tag to the page where you want it to appear.
<html>
<head>
<script async src="https://ui.s.usemansar.xyz/release/latest/components.js"></script>
<!-- For production environment use `https://ui.usemansar.xyz/release/latest/components.js` as the script source.-->
</head>
<body>
<mansar-elements-white-label-app jwt-token="{{JwtToken}}" theme="{{themeUrl}}" language="{{languageUrl}}"> </mansar-elements-white-label-app>
</body>
</html>You can choose to create mansar-elements-white-label-app dynamically using JavaScript
<html>
<head>
<script async src="https://ui.usemansar.xyz/release/latest/components.js"></script>
</head>
<body>
<div id="mansar-app-placeholder"></div>
<script>
const mansar = document.createElement("mansar-elements-white-label-app")
mansar.setAttribute("theme", "{{themeUrl}}")
mansar.setAttribute("jwt-token", "{{JwtToken}}")
mansar.setAttribute("language", "{{languageUrl}}")
document.querySelector("#mansar-app-placeholder").append(mansar)
</script>
</body>
</html>CAUTION
White-label app will use 2 keys in local storage. mansarCustomerToken and mansarVerifiedCustomerToken. It's important to clean them up when the user logs out from the app.
localStorage.removeItem("mansarCustomerToken")
localStorage.removeItem("mansarVerifiedCustomerToken")Prefilling the Application Form (KYB / KYC)
In order to pre-populate the Application Form (KYB) with data that the client already collected about their end-user, the client will need to implement an GET API endpoint which by request via JWT Token returns the Mansar ApplicationFormPrefill resource. Please, contact Mansar in order to configure the endpoint.
Request that Mansar will send to the client's endpoint:
curl -X GET 'https://yourdomain.com/mansar/application-form-prefill' \
-H "Authorization: Bearer ${JWT Token}"Last updated