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 |