The Transactions Object

A transaction is an individual entry that represents a financial movement on a Fiat Account. The Transaction object represents completed transactions that were posted to the account, including the amount, direction and transaction type.

You cannot create Transactions via the Fiat Republic API, as they reflect the actual movement of funds, and are created by Fiat Republic. For example, if you create a SEPA payment, the transaction will be created once the payment is completed and the funds have been debited from the Fiat Account.

Transactions are final, and cannot be deleted or updated.

Transaction Object

Attribute

Description

Format/Enum

id string

Unique identifier of the transaction.

e.g. txn_d4pmer37x8182gkv5b

fiatAccountId
string

Unique identifier of the Fiat Account on which the transaction was created.

amount
string

Amount of the transaction in 2 decimal places.

e.g. 121.21

balanceAfter
string

Account balance after the transaction occurred.

currency
string

Currency of the transaction.

Three-letter ISO 4217 code e.g. GBP,EUR , USD

direction
string

Direction of the transaction.

DEBIT, CREDIT

type
string

Type of the transaction.

PAYMENT, TRANSFER, CONVERSION, RETURN

counterparty
string

Name of the counterparty of the transaction. Typically the name of the Payer, Payee or Fiat Account depending on the transaction type.

cause
object

Object containing details of the entity that caused the transaction to be posted.

cause.type
string

Type of the entity that caused the transaction to be posted.

PAYMENT, CONVERSION, RETURN

cause.id
string

Identifier of the entity that caused the transaction to be posted.

cause.reference
string

Reference of the entity that caused the transaction to be posted.

createdAt
integer

Epoch timestamp at which the object was created.

e.g. 1637593856104