HomeGuidesChangelogDiscussions
Log In
Guides

What is a float?

An integrator's float is a liquidity balance, domiciled with Juice from which user's cards would be funded. It works like an account that holds funding for a card integrator with Juice. An integrator can credit their float, or take out from same any time they wish.

📘

Purpose for Float

• Cards are funded from an integrator's float.
• Funds in cards can be sent back to the integrator's float.
• Float can be funded and defunded anytime.

Float Balance

An integrator can call for their float balance whenever they want. The endpoint /card-integrators/floatworks for this purpose.

curl --request GET \
     --url https://api-sandbox.spendjuice.com/card-integrators/float \
     --header 'Accept: application/json'

Float Top-Up

To top-up an integrator's float balance, use the card-integrators/top-up-float endpoint. When using this endpoint, include the amount you would like to top-up.
Remember that all cards use the USD currency, so it's unnecessary to specify the currency for the top-up amount because it's just one that we support.

An integrator's float can also be credited from users' card balance. A card's funds can be debited right back into the float. Get into details on this in the Debit Card Balance section in Manage Cards.

Float Debit

A float balance is deducted when an integrator credits their users' cards. This implies that whenever a card is credited, an integrator float balance drops.