Finix.js Reference
link to finixjs-reference Finix.js Reference Copy - Copy for LLM Copy page as Markdown for LLMs - View as Markdown\ \ Open this page as Markdown - Open in ChatGPT\ \ Get insights from ChatGPT - Open in Claude\ \ Get insights from Claude - Connect to Cursor Install MCP server on Cursor - Connect to VS Code Install MCP server on VS Code
Finix.js is a client-side JavaScript library for securely collecting and tokenizing payment details. It renders an embedded payment form inside an iframe, keeping sensitive card and bank data out of your application and ensuring PCI compliance.
link to finixjs-example Finix.js Example
This form is rendered by finix.js in the Sandbox environment — the same library you embed in your site. Submit test card details to see the Token Response your onSubmit callback receives.
Country🇺🇸 United States🇨🇦 CanadaThemeFinixAmethystSapphireTopazRubyEmeraldMidnightElevatedDark ModeDisabledEnabledSize🖥️ Desktop📱 MobilePayment Methods💳 Card & Bank💳 Card only🏦 Bank onlyFull AddressShownHidden
Payment Form
Credit Card
Name
Potential issues detected
Card Number
Card number is required
Potential issues detected
Expiration
Expiration date is required
Potential issues detected
CVV/CVC
Security code is required
Potential issues detected
CountryAfghanistanÅland IslandsAlbaniaAlgeriaAmerican SamoaAndorraAngolaAnguillaAntarcticaAntigua and BarbudaArgentinaArmeniaArubaAustraliaAustriaAzerbaijanBahamasBahrainBangladeshBarbadosBelarusBelgiumBelizeBeninBermudaBhutanBoliviaBonaire, Sint Eustatius and SabaBosnia and HerzegovinaBotswanaBouvet IslandBrazilBritish Indian Ocean TerritoryBruneiBulgariaBurkina FasoBurundiCambodiaCameroonCanadaCape VerdeCayman IslandsCentral African RepublicChadChileChinaChristmas IslandCocos (Keeling) IslandsColombiaComorosCongoCongo (Democratic Republic)Cook IslandsCosta RicaCôte d'IvoireCroatiaCubaCuraçaoCyprusCzech RepublicDenmarkDjiboutiDominicaDominican RepublicEcuadorEgyptEl SalvadorEquatorial GuineaEritreaEstoniaEthiopiaFalkland IslandsFaroe IslandsFijiFinlandFranceFrench GuianaFrench PolynesiaFrench Southern TerritoriesGabonGambiaGeorgiaGermanyGhanaGibraltarGreeceGreenlandGrenadaGuadeloupeGuamGuatemalaGuernseyGuineaGuinea-BissauGuyanaHaitiHeard Island and McDonald IslandsVatican CityHondurasHong KongHungaryIcelandIndiaIndonesiaIranIraqIrelandIsle of ManIsraelItalyJamaicaJapanJerseyJordanKazakhstanKenyaKiribatiNorth KoreaSouth KoreaKosovoKuwaitKyrgyzstanLaosLatviaLebanonLesothoLiberiaLibyaLiechtensteinLithuaniaLuxembourgMacaoNorth MacedoniaMadagascarMalawiMalaysiaMaldivesMaliMaltaMarshall IslandsMartiniqueMauritaniaMauritiusMayotteMexicoMicronesiaMoldovaMonacoMongoliaMontenegroMontserratMoroccoMozambiqueMyanmarNamibiaNauruNepalNetherlandsNetherlands AntillesNew CaledoniaNew ZealandNicaraguaNigerNigeriaNiueNorfolk IslandNorthern Mariana IslandsNorwayOmanPakistanPalauPalestinePanamaPapua New GuineaParaguayPeruPhilippinesPitcairnPolandPortugalPuerto RicoQatarRéunionRomaniaRussiaRwandaSaint BarthélemySaint HelenaSaint Kitts and NevisSaint LuciaSaint MartinSaint Pierre and MiquelonSaint Vincent and the GrenadinesSamoaSan MarinoSão Tomé and PríncipeSaudi ArabiaSenegalSerbiaSeychellesSierra LeoneSingaporeSint MaartenSlovakiaSloveniaSolomon IslandsSomaliaSouth AfricaSouth Georgia and the South Sandwich IslandsSouth SudanSpainSri LankaSudanSurinameSvalbard and Jan MayenEswatiniSwedenSwitzerlandSyriaTaiwanTajikistanTanzaniaThailandTimor-LesteTogoTokelauTongaTrinidad and TobagoTunisiaTurkeyTurkmenistanTurks and Caicos IslandsTuvaluUgandaUkraineUnited Arab EmiratesUnited KingdomUnited StatesUnited States Minor Outlying IslandsUruguayUzbekistanVanuatuVenezuelaVietnamBritish Virgin IslandsU.S. Virgin IslandsWallis and FutunaWestern SaharaYemenZambiaZimbabwe
Potential issues detected
Zip
Potential issues detected
Bank Account
Name
Potential issues detected
Bank Account Number
Account number is required
Potential issues detected
Confirm Bank Account Number
Account numbers do not match
Potential issues detected
Routing Number
Routing number is required
Potential issues detected
Account TypeBusiness CheckingBusiness SavingsPersonal CheckingPersonal Savings
Account type is required
Potential issues detected
Potential issues detected
Want to securely link your bank account? Link instantly using Plaid.
Add your bank
Search for your bank
Search for your bank
What is Plaid?
Can't find your bank? Enter details manually.
Tokenize
Add your bank
Finix.PaymentForm("payment-form", "sandbox", "APgPDQrLD52TYvqazjHJJchM", {
theme: "finix",
paymentMethods: ["card", "bank"],
showAddress: false,
defaultValues: { address_country: "USA" },
onSubmit: function (error, response) { /* ... */ },
});
link to quick-start Quick Start
<!-- 1. Include the script -->
<script src="https://js.finix.com/v/2/finix.js"></script>
<!-- 2. Add a mount point -->
<div id="payment-form"></div>
<script>
<!-- 3. Initialize the form -->
Finix.PaymentForm(
"payment-form",
"sandbox",
"APgPDQrLD52TYvqazjHJJchM",
{
onSubmit: function (error, response) {
if (error) {
console.error("Error:", error);
return;
}
const tokenData = response.data || {};
// Send the token to your backend
fetch("/your/backend", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
token: tokenData.id,
}),
});
},
}
);
</script>
link to including-finixjs Including finix.js
Always load the library directly from https://js.finix.com. Never self-host or bundle finix.js — doing so breaks PCI compliance.
<script src="https://js.finix.com/v/2/finix.js"></script>
link to global-api Global API
| Method | Description |
|---|---|
| Finix.PaymentForm() | Create and render a secure payment form for collecting card and bank details. |