/* ================================================================================================
   FONT IMPORTS & DEFINITIONS
   ================================================================================================ */

@import url('https://fonts.googleapis.com/css2?family=Figtree:ital,wght@0,300..900;1,300..900&family=Space+Grotesk:wght@300..700&family=Space+Mono:wght@400;700&display=swap');

@font-face {
	font-family: var(--font-primary);
	src: url('https://formance01.b-cdn.net/PolymathVar.woff2') format('woff2');
	font-weight: 100 900;
	font-display: swap;
}

/* ================================================================================================
   CSS CUSTOM PROPERTIES (DESIGN SYSTEM VARIABLES)
   ================================================================================================ */

:root {
	/* Font Family Variables */
	--font-primary: 'Polymath', 'Figtree', sans-serif;
	--font-secondary: 'Space Grotesk', sans-serif;
	--font-mono: 'Space Mono', monospace;

	/* Base Colors */
	--white: var(--emerald-50);
	--black: var(--emerald-800);

	/* Core Theme Colors */
	--background: var(--white);
	--foreground: var(--black);

	--muted: var(--emerald-100);
	--muted-lighter: 180, 14%, 97%;
	--muted-foreground: var(--emerald-600);

	--card: var(--background);
	--card-foreground: var(--foreground);

	--popover: var(--background);
	--popover-foreground: var(--foreground);

	--border: var(--emerald-200);
	--input: var(--emerald-200);

	--primary: var(--emerald-700);
	--primary-foreground: var(--white);

	--secondary: var(--emerald-100);
	--secondary-foreground: var(--foreground);

	--accent: var(--muted-lighter);
	--accent-foreground: var(--foreground);

	--ring: var(--emerald-500);
	--radius: 0.5rem;

	/* Emerald Palette */
	--emerald-50: 0, 0%, 100%;
	--emerald-100: 180, 14%, 93%;
	--emerald-200: 180, 16%, 89%;
	--emerald-300: 180, 17%, 86%;
	--emerald-400: 184, 13%, 75%;
	--emerald-500: 184, 11%, 53%;
	--emerald-600: 186, 22%, 33%;
	--emerald-700: 187, 97%, 12%;
	--emerald-800: 187, 96%, 9%;
	--emerald-900: 185, 100%, 5%;

	/* Lilac Palette */
	--lilac-100: 240, 82%, 98%;
	--lilac-200: 243, 100%, 96%;
	--lilac-300: 242, 100%, 94%;
	--lilac-400: 243, 100%, 92%;
	--lilac-500: 242, 100%, 90%;
	--lilac-600: 243, 43%, 75%;
	--lilac-700: 242, 29%, 59%;
	--lilac-800: 243, 28%, 44%;
	--lilac-900: 242, 45%, 29%;

	/* Gold Palette */
	--gold-100: 42, 18%, 86%;
	--gold-200: 44, 17%, 74%;
	--gold-300: 42, 17%, 63%;
	--gold-400: 43, 17%, 51%;
	--gold-500: 43, 26%, 39%;
	--gold-600: 43, 26%, 31%;
	--gold-700: 43, 27%, 24%;
	--gold-800: 42, 25%, 16%;
	--gold-900: 42, 25%, 8%;

	/* Cobalt Palette */
	--cobalt-100: 205, 46%, 90%;
	--cobalt-200: 205, 48%, 90%;
	--cobalt-300: 206, 47%, 69%;
	--cobalt-400: 206, 48%, 59%;
	--cobalt-500: 206, 50%, 45%;
	--cobalt-600: 206, 50%, 39%;
	--cobalt-700: 206, 49%, 29%;
	--cobalt-800: 206, 50%, 20%;
	--cobalt-900: 205, 48%, 10%;

	/* Mint Palette */
	--mint-100: 126, 56%, 96%;
	--mint-200: 123, 56%, 93%;
	--mint-300: 122, 52%, 89%;
	--mint-400: 122, 53%, 86%;
	--mint-500: 122, 53%, 82%;
	--mint-600: 123, 27%, 68%;
	--mint-700: 123, 16%, 53%;
	--mint-800: 122, 18%, 39%;
	--mint-900: 122, 25%, 24%;

	/* Semantic Color Backgrounds & Foregrounds */
	--red-background: 2, 93%, 94%;
	--red-foreground: 0, 75%, 42%;
	--orange-background: 19, 100%, 94%;
	--orange-foreground: 18, 89%, 40%;
	--amber-background: 43, 95%, 92%;
	--amber-foreground: 26, 89%, 37%;
	--yellow-background: 45, 100%, 92%;
	--yellow-foreground: 35, 92%, 33%;
	--lime-background: 86, 76%, 92%;
	--lime-foreground: 86, 78%, 27%;
	--green-background: 135, 56%, 89%;
	--green-foreground: 142, 70%, 26%;
	--teal-background: 170, 47%, 90%;
	--teal-foreground: 175, 79%, 26%;
	--cyan-background: 189, 85%, 92%;
	--cyan-foreground: 193, 83%, 31%;
	--sky-background: 202, 82%, 94%;
	--sky-foreground: 201, 94%, 32%;
	--blue-background: 220, 93%, 94%;
	--blue-foreground: 224, 77%, 48%;
	--indigo-background: 240, 92%, 95%;
	--indigo-foreground: 245, 58%, 51%;
	--violet-background: 258, 92%, 95%;
	--violet-foreground: 263, 70%, 50%;
	--purple-background: 269, 100%, 95%;
	--purple-foreground: 272, 72%, 47%;
	--fuchsia-background: 294, 90%, 96%;
	--fuchsia-foreground: 295, 72%, 40%;
	--pink-background: 327, 91%, 96%;
	--pink-foreground: 335, 77%, 42%;
	--rose-background: 351, 100%, 96%;
	--rose-foreground: 346, 82%, 41%;
	--zinc-background: 240, 3%, 93%;
	--zinc-foreground: 240, 5%, 26%;

	/* Sidebar Variables */
	--sidebar-background: var(--background);
	--sidebar-foreground: var(--foreground);
	--sidebar-primary: var(--emerald-400);
	--sidebar-primary-foreground: var(--white);
	--sidebar-accent: var(--accent);
	--sidebar-accent-foreground: var(--foreground);
	--sidebar-border: var(--border);
	--sidebar-ring: var(--ring);
	--sidebar-menu-sub-border: var(--sidebar-primary);

	/* Chart Colors */
	--chart-1: var(--emerald-600);
	--chart-2: var(--lilac-600);
	--chart-3: var(--gold-500);
	--chart-4: var(--cobalt-500);
	--chart-5: var(--mint-500);

	/* Status Colors */
	--valid: var(--green-background);
	--valid-foreground: var(--green-foreground);
	--destructive: var(--red-background);
	--destructive-foreground: var(--red-foreground);
	--warning: var(--amber-background);
	--warning-foreground: var(--amber-foreground);
	--info: var(--sky-background);
	--info-foreground: var(--sky-foreground);
}

/* ================================================================================================
   DARK MODE OVERRIDES
   ================================================================================================ */

.dark {
	/* Base Dark Mode Colors */
	--black: var(--emerald-800);
	--background: var(--emerald-900);
	--foreground: var(--white);

	--muted: 187, 96%, 5%;
	--muted-lighter: 187, 96%, 7%;
	--muted-foreground: var(--emerald-300);

	--popover: var(--background);
	--popover-foreground: var(--foreground);

	--card: var(--background);
	--card-foreground: var(--foreground);

	--border: var(--emerald-700);
	--input: var(--emerald-700);

	--primary: var(--emerald-700);
	--primary-foreground: var(--white);

	--secondary: var(--emerald-800);
	--secondary-foreground: var(--emerald-900);

	--accent: var(--emerald-700);
	--accent-foreground: var(--emerald-100);

	/* Dark Mode Semantic Colors */
	--red-background: 0, 84%, 15%;
	--red-foreground: 0, 91%, 74%;
	--orange-background: 18, 26%, 15%;
	--orange-foreground: 27, 96%, 61%;
	--amber-background: 39, 22%, 15%;
	--amber-foreground: 43, 96%, 56%;
	--yellow-background: 44, 25%, 15%;
	--yellow-foreground: 50, 98%, 54%;
	--lime-background: 88, 17%, 15%;
	--lime-foreground: 82, 85%, 71%;
	--green-background: 143, 18%, 14%;
	--green-foreground: 142, 69%, 58%;
	--teal-background: 185, 17%, 14%;
	--teal-foreground: 171, 77%, 64%;
	--cyan-background: 186, 96%, 8%;
	--cyan-foreground: 186, 96%, 69%;
	--sky-background: 207, 26%, 15%;
	--sky-foreground: 199, 95%, 74%;
	--blue-background: 222, 33%, 18%;
	--blue-foreground: 213, 94%, 68%;
	--indigo-background: 240, 26%, 19%;
	--indigo-foreground: 234, 89%, 74%;
	--violet-background: 256, 26%, 18%;
	--violet-foreground: 256, 92%, 76%;
	--purple-background: 266, 30%, 18%;
	--purple-foreground: 270, 95%, 75%;
	--fuchsia-background: 284, 18%, 17%;
	--fuchsia-foreground: 293, 91%, 73%;
	--pink-background: 317, 18%, 16%;
	--pink-foreground: 329, 86%, 70%;
	--rose-background: 340, 19%, 16%;
	--rose-foreground: 351, 95%, 71%;
	--zinc-background: 240, 4%, 15%;
	--zinc-foreground: 240, 5%, 82%;

	/* Dark Mode Sidebar */
	--sidebar-background: var(--background);
	--sidebar-foreground: var(--foreground);
	--sidebar-primary: var(--emerald-500);
	--sidebar-primary-foreground: var(--white);
	--sidebar-accent: var(--accent);
	--sidebar-accent-foreground: var(--accent-foreground);
	--sidebar-border: var(--border);
	--sidebar-border-items: var(--border);
	--sidebar-ring: var(--ring);

	/* Dark Mode Charts */
	--chart-1: 220 70% 50%;
	--chart-2: 160 60% 45%;
	--chart-3: 30 80% 55%;
	--chart-4: 280 65% 60%;
	--chart-5: 340 75% 55%;

	/* Dark Mode Status Colors */
	--valid: var(--green-background);
	--valid-foreground: var(--green-foreground);
	--destructive: var(--red-background);
	--destructive-foreground: var(--red-foreground);
	--warning: var(--amber-background);
	--warning-foreground: var(--amber-foreground);
	--info: var(--sky-background);
	--info-foreground: var(--sky-foreground);

	/* Dark Mode Specific Components */
	.eyebrow {
		color: hsl(var(--gold-300)) !important;
	}

	#welcome-header {
		background-color: hsl(var(--emerald-900)) !important;
	}

	/* Dark Mode Utility Classes */
	.dark\:bg-codeblock:is(.dark *) {
		background-color: hsl(var(--background)) !important;
	}

	.dark\:text-primary-light:is(.dark *) {
		color: hsl(var(--emerald-200)) !important;
	}
}

.bg-codeblock {
	background-color: hsl(var(--background)) !important;
}

/* ================================================================================================
   GLOBAL BASE STYLES
   ================================================================================================ */

* {
	border-color: hsl(var(--border));
	color: var(--foreground);
}

body {
	font-family: var(--font-primary);
}

p, .paragraph {
	color: hsl(var(--muted-foreground)) !important;
}

/* Font Utility Classes */
.font-primary {
	font-family: var(--font-primary);
	font-variation-settings: 'opsz' 72;
	font-feature-settings: normal;
}

.font-secondary {
	font-family: var(--font-secondary);
}

.font-mono,
.mint-font-mono {
	font-family: var(--font-mono) !important;
	font-variation-settings: 'opsz' 72;
	font-feature-settings: normal;
	letter-spacing: -0.025em;
}

/* Text Utility Classes */
.text-foreground {
	color: hsl(var(--foreground)) !important;
}

.text-muted-foreground {
	color: hsl(var(--muted-foreground)) !important;
}
/* Background Utility Classes */
.bg-background {
	background-color: hsl(var(--background)) !important;
}

.bg-background-light,
.bg-background-dark {
	background-color: hsl(var(--background)) !important;
}

.bg-muted {
	background-color: hsl(var(--muted)) !important;
}

.bg-gradient-to-b {
	background: none !important;
}

.border-b {
	border-color: hsl(var(--border)) !important;
}

/* ================================================================================================
   TYPOGRAPHY OVERRIDES
   ================================================================================================ */

h1,
h1 > p,
h2,
h2 > p,
h3,
h3 > p {
	color: hsl(var(--foreground)) !important;
	font-family: var(--font-primary);
	font-feature-settings: normal;
}

p,
.nav-tabs-item,
#sidebar-group li div,
#navigation-items a,
.navbar-link a {
	color: hsl(var(--muted-foreground)) !important;
}

.eyebrow {
	font-family: var(--font-mono);
	text-transform: uppercase;
	color: hsl(var(--gold-400)) !important;
}

/* ================================================================================================
   NAVIGATION & HEADER COMPONENTS
   ================================================================================================ */

#navbar {
	background-color: hsl(var(--background)) !important;
}

#navbar-transition {
	display: none !important;
}

#navbar .flex.items-center.gap-x-2 button {
	color: hsl(var(--gold-400)) !important;
	border: 1px solid hsl(var(--gold-300)) !important;
}

.nav-tabs-item.font-semibold div {
	background-color: hsl(var(--gold-200)) !important;
}

.nav-dropdown-item-icon {
	border: none;

	img {
		border-radius: var(--radius);
		height: 32px;
		width: 32px;
	}
}

/* ================================================================================================
   WELCOME HERO SECTION
   ================================================================================================ */

#welcome-hero {
	background: url('https://mintlify.s3.us-west-1.amazonaws.com/formance-d105fefb/assets/images/welcome-pattern.png') no-repeat center center / 105% hsl(var(--emerald-700));

	&::before {
		content: '';
		position: absolute;
		top: 0;
		left: 0;
		width: 100%;
		height: 100%;
		background-color: hsl(var(--emerald-700), 0.7) !important;
	}

	h1 {
		color: hsl(var(--white)) !important;
	}

	p {
		color: hsl(var(--emerald-200)) !important;
	}

	#welcome-button {
		background-color: hsl(var(--gold-500)) !important;
		color: hsl(var(--emerald-200)) !important;
		border-radius: var(--radius);
		padding: 0.5rem 1rem;
	}
}

/* ================================================================================================
   CARD COMPONENTS
   ================================================================================================ */

.card {
	background-color: hsl(var(--background)) !important;
	border: 1px solid hsl(var(--border)) !important;
	border-radius: var(--radius);

	&:hover {
		border: 1px solid hsl(var(--emerald-400)) !important;

		.dark & {
			border: 1px solid hsl(var(--emerald-600)) !important;
		}

	}


	p {
		font-size: 1rem;
	}

	[data-component-part='card-icon'] {
		height: 36px;
		width: 36px;
		border-radius: var(--radius);
		padding: 0.4rem;
		background-color: hsl(var(--emerald-600)) !important;
		display: flex;
		justify-content: center;
		align-items: center;

		svg {
			height: 24px;
			width: 24px;
			fill: hsl(var(--emerald-200)) !important;
			color: hsl(var(--emerald-200)) !important;
			background-color: hsl(var(--emerald-200)) !important;
		}
	}
}

/* ================================================================================================
   BUTTON COMPONENTS
   ================================================================================================ */

.button,
#topbar-cta-button {
	display: inline-block;
	background-color: hsl(var(--emerald-700)) !important;
	color: hsl(var(--emerald-200)) !important;
	border-radius: var(--radius);
}

.tryit-button {
	background-color: hsl(var(--cobalt-500)) !important;
}

/* ================================================================================================
   TABLE OF CONTENTS & FOOTER
   ================================================================================================ */

#table-of-contents {
	svg,
	span {
		color: hsl(var(--foreground)) !important;
	}
}

#table-of-contents-content a {
	color: hsl(var(--muted-foreground)) !important;
}

#footer svg {
	fill: hsl(var(--foreground)) !important;
	color: hsl(var(--foreground)) !important;
	background-color: hsl(var(--foreground)) !important;
}

/* ================================================================================================
   NUMSCRIPT SYNTAX HIGHLIGHTING
   ================================================================================================ */

html.dark .language-numscript .shiki,
html .language-numscript {
	code {
		font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
		font-size: 0.875rem;
		line-height: 1.6;
		white-space: pre;
		display: block;
		color: #abb2bf;
		background: none !important;
	}

	/* Comments */
	.token.comment {
		color: hsl(var(--muted-foreground)) !important;
		font-style: italic;
	}

	/* Strings */
	.token.string.regexp {
		color: hsl(var(--cobalt-500)) !important;
	}

	.token.string.quoted {
		color: hsl(var(--mint-800)) !important;
	}

	.token.string.other {
		color: hsl(var(--mint-700)) !important;
	}

	/* Variables & Constants */
	.token.variable.parameter {
		color: hsl(var(--gold-400)) !important;
	}

	.token.constant.numeric.decimal,
	.token.constant.numeric.percentage,
	.token.constant.numeric.fraction {
		color: #d19a66 !important;
	}

	.token.constant.language {
		color: hsl(var(--lilac-700)) !important;
	}

	/* Keywords */
	.token.keyword.meta {
		color: hsl(var(--lilac-600)) !important;
	}

	.token.keyword.control {
		color: hsl(var(--emerald-600)) !important;
	}

	.token.keyword.state {
		color: hsl(var(--lilac-600)) !important;
	}

	/* Functions */
	.token.entity.name.function {
		color: hsl(var(--mint-800)) !important;
		font-weight: 500;
	}
}

/* ================================================================================================
   MERMAID
   ================================================================================================ */

.mermaid {
	.nodes {
		rect {
			fill: hsl(var(--mint-300)) !important;
			stroke: hsl(var(--mint-700)) !important;
		}

		p {
			color: hsl(var(--emerald-700)) !important;
		}
	}

	.edgeLabels {
		.edgeLabel,
		.edgeLabel p {
			background-color: hsl(var(--cobalt-200)) !important;
			color: hsl(var(--cobalt-700)) !important;
		}
	}
}


;(function () {
	const tokenDefs = [
		[/\/\*[\s\S]*?\*\//g, 'comment block'],
		[/\/\/[^\n]*/g, 'comment line'],
		[/"[^"]*"/g, 'string quoted'],
		[/\[[^\]]+\]/g, 'string regexp'],
		[/@[a-zA-Z_]+[a-zA-Z0-9_:]*/g, 'string other'],
		[/\$[a-z_]+[a-z0-9_]*/gi, 'variable parameter'],
		[/\b[0-9]+(?:\.[0-9]+)?%\b/g, 'constant numeric percentage'],
		[/\b[0-9]+\/[0-9]+\b/g, 'constant numeric fraction'],
		[/\b[0-9]+(?:\.[0-9]+)?\b/g, 'constant numeric decimal'],
		[/\b(?:vars|source|destination)\b/gi, 'constant language'],
		[/\b(?:set_tx_meta|set_account_meta)\b/gi, 'keyword meta'],
		[/\b(?:print|fail|save)\b/gi, 'keyword control'],
		[/\b(?:send|remaining|to|max|from)\b/gi, 'entity name function'],
		[/\b(?:account|monetary|asset|number|string|portion)\b/gi, 'keyword state'],
	]

	function escapeHtml(str) {
		return str.replace(/[&<>"']/g, (ch) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[ch]))
	}

	function tokenize(content) {
		const matches = []

		for (const [regex, type] of tokenDefs) {
			let match
			while ((match = regex.exec(content))) {
				matches.push({
					start: match.index,
					end: match.index + match[0].length,
					text: match[0],
					type,
				})
			}
		}

		// Sort by start index
		matches.sort((a, b) => a.start - b.start)

		// Filter overlaps
		const nonOverlapping = []
		let lastEnd = 0
		for (const token of matches) {
			if (token.start >= lastEnd) {
				nonOverlapping.push(token)
				lastEnd = token.end
			}
		}

		return nonOverlapping
	}

	function highlight(content) {
		const tokens = tokenize(content)
		let result = ''
		let lastIndex = 0

		for (const token of tokens) {
			// Add plain text before match
			result += escapeHtml(content.slice(lastIndex, token.start))
			// Add highlighted token
			result += `<span class="token ${token.type}">${escapeHtml(token.text)}</span>`
			lastIndex = token.end
		}

		// Add remaining content
		result += escapeHtml(content.slice(lastIndex))
		return result
	}

	function highlightNumscript() {
		const blocks = document.querySelectorAll('.language-numscript code')
		let processedCount = 0

		blocks.forEach((codeEl) => {
			const block = codeEl.closest('.language-numscript')
			if (!block || block.dataset.highlighted === 'true') {
				if (block && block.hasAttribute('data-loaded')) {
					processedCount++
				}
				return
			}

			const raw = codeEl.textContent
			const lines = raw.split('\n')
			const html = lines.map(highlight).join('\n')
			codeEl.innerHTML = html
			block.dataset.highlighted = 'true'
			block.setAttribute('data-loaded', '')
			processedCount++
		})

		// Keep trying if not all blocks have been processed
		const totalBlocks = document.querySelectorAll('.language-numscript').length
		if (processedCount < totalBlocks) {
			setTimeout(highlightNumscript, 100)
		}
	}

	// Make the function globally available
	window.highlightNumscript = highlightNumscript

	// Initial highlighting on load
	window.addEventListener('load', () => {
		setTimeout(highlightNumscript, 100)
		setTimeout(highlightNumscript, 200)
	})

	// Watch for dynamically added content
	const observer = new MutationObserver((mutations) => {
		mutations.forEach((mutation) => {
			if (mutation.addedNodes.length > 0) {
				// Delay execution to ensure content is fully rendered
				setTimeout(highlightNumscript, 50)
			}
		})
	})

	// Start observing when DOM is ready
	if (document.readyState === 'loading') {
		document.addEventListener('DOMContentLoaded', () => {
			observer.observe(document.body, {
				childList: true,
				subtree: true,
			})
		})
	} else {
		observer.observe(document.body, {
			childList: true,
			subtree: true,
		})
	}
})()


Read the config of a connector

The frequency at which the connector will try to fetch new BalanceTransaction objects from Adyen API.


The access key used by the connector for authorizing requests to the Atlar API.
You can obtain it along with the associated secret from the Atlar dashboard.


The base URL the client uses for making requests towards the Atlar API.


Number of items to fetch when querying paginated APIs.


The frequency at which the connector tries to fetch new Transaction objects from the Atlar API.


The secret used by the connector for authorizing requests to the Atlar API.
You can obtain it along with the associated access key from the Atlar dashboard.


The frequency at which the connector tries to fetch the status of payment initiations from the Atlar API.


The frequency at which the connector will try to fetch new BalanceTransaction objects from Banking Circle API.


The endpoint to use for the API. Defaults to https://devapi.currencycloud.com

The frequency at which the connector will fetch transactions

The frequency at which the connector will try to fetch new payment objects from the directory

The frequency at which the connector will try to fetch new BalanceTransaction objects from the API.


The frequency at which the connector will try to fetch new BalanceTransaction objects from MangoPay API.


The frequency at which the connector will try to fetch new BalanceTransaction objects from Modulr API.


The frequency at which the connector will try to fetch new BalanceTransaction objects from MoneyCorp API.


Number of BalanceTransaction to fetch at each polling interval.


The frequency at which the connector will try to fetch new BalanceTransaction objects from Stripe API.


The frequency at which the connector will try to fetch new BalanceTransaction objects from Wise API.


API Reference v3.0

Read the config of a connector

Authorizations

Path Parameters

Response