Skip to main content

Mastering Numscript

Have you worked through the Hello World tutorial, and now you're ready to do more with Numscript? In this series of guides, we walk you through specific use cases to help you understand how to get the most out of Numscript and Formance Ledger.


Before you begin on any of them, be sure that you're set up properly: Read through the prerequisites first!.


Everything you need to get started with these guides.

Transactions with multiple destinations

Sometimes you need to split a payment across multiple destinations. Learn how to do this with Numscript.

Transactions with multiple sources

Sometimes you need to split a payment across multiple sources. Learn how to do this with Numscript.

Making requests over HTTP

You can also execute Numscript with the Formance API.

Numscript templates

Reuse the same transaction structure with Numscript templates.

Working with currencies

How does Numscript handle different currencies, and how do you specify the level of precision you need to work with?

Adding metadata to transactions

You can add custom metadata to transactions in Numscript, which can be made available to external services.

Making partial transfers with kept

Sometimes you need to transfer only a portion of a full transaction, for example when calculating additional fees.


To better represent your flows, it can be useful to allow overdrafts on some ledger accounts. This article explains how to do that.