Skip to main content
Fluz App Widgets, or just Fluz Widgets, are developer applications that can be hosted by developers on their own websites. These widgets can be customized to access certain features on behalf of Fluz users like transferring funds into their account or out of their account into gift cards and virtual cards. These widgets can be created and managed from the developer dashboard along with regular develop applications. Here’s a description of how you can use Fluz Widgets in your application:
  1. Install widget
    1. Add the initiation URL in our Fluz portal
  2. Add button on your withdrawal page to initiate widget
  3. Add button on your payment method page to initiate widget
Once an end user visits the page with the Fluz Widget and takes an action that will cause the widget’s modal to show (see examples), the user will be taken through the following steps:
  1. User will log into their Fluz account with a 2FA to their phone number. If they do not have a Fluz account, they will create one.
  2. Complete KYC on User >
    1. If you have SSN, pass it to us so we can validate
    2. If not, we will take the user through the KYC flow on our end
  3. Handle response from user KYC
    1. Success on user KYC
    2. Failure on user KYC
  4. Prompt the user to set a PIN in Fluz. This is a security measure added to the Fluz app and widgets, and will be prompted when the user takes some actions that require extra security.

​
Withdraw funds from your app

📘 Check your account’s Fluz balance to ensure you have enough funds. If you do not have enough funds to cover the transfer, initiate a deposit with selected funding source.
📘 Remove or quarantine the user’s funds from their account to prevent the potential duplication of funds moving.
  1. User enters withdrawal amount & clicks button on withdrawal page
  2. User will be taken to a confirmation screen via the widget to confirm the transfer.
    1. If the user confirms, we will initiate the transfer from your spend account to the user’s spend account.
    2. If the user denies or closes the modal, we will send an event .
  3. Complete or failure event from us
  4. Widget will show the user their withdrawal was complete and they can directly access their Fluz virtual card.

​
Deposit funds to your app

📘 Check user’s Fluz balance to ensure they have enough funds to cover the transaction
  1. User enters deposit amount & clicks button on deposit page
  2. User will be taken to a confirmation screen via the widget to confirm the transfer.
    1. If the user confirms, we will initiate the transfer from the user’s spend account to your spend account.
    2. If the user denies or closes the modal, we will send an event.
  3. Complete or failure event from us
📘 Check your account’s Fluz balance to ensure transfer was completed