Skip to main content
A virtual account is a set of bank details Kira opens for one user. Money sent to those details arrives as a deposit, and what the account does with it — hold it as fiat, or convert and forward it — is fixed when you create the account. The bank fills in most fields on this object, not you, so an account read straight after creation carries very little. The bank details arrive when the bank assigns them, and until then they are null.

Example

What the account is

Where money goes

methods and payment_methods are two names for one value, both returned on every read. Pick one and use it everywhere.

The flattened bank details

The bank details repeated at the top level, projected from the deposit instructions the account holds. All of them are null until the bank assigns the account.

Your fees

You set markup when you create the account and can change it later with Update a virtual account. A change applies to deposits that settle after it. A deposit that already settled keeps its markup.