Payment
This page contains all relevant terminology regarding Payments.
BankAccount
Definition
A BankAccount is a regular bank account used to receive and transfer Cash.
Statement
Definition
Each InvestorAccount has a list of Statements linked to it. In such a Statement is specified what the ~Account~’s opening and closing balances were on a specific date and the difference between these two balances.
Entry
Definition
The difference between the opening and closing balance in a Statement is composed by a list of Entries. Each of these Entries represents a transaction with a certain value that occurred on the day of the corresponding Statement.
TransactionType
Definition
Every Entry has its own TransactionType. This is either ‘Regular’, ‘AccruedBenefits’ or ‘Refund’. For filtering purposes, refunds have their own TransactionType.
AccruedBenefits
Definition
AccruedBenefits are built up financial positions from the past. A ~Transaction~ is of type ‘AccruedBenefits’ when an Investor transfers funds from a different Label to the current Label. E.g. when an individual switches pensionfunds.
CamtFile
Definition
A CAMT.053 (Cash Management) file is a bank to customer statement, providing the customer with a prior or previous day overview of transactions. GiroPro uses CAMT.053 files to obtain information on the transferal of money to InvestorAccounts. After this information has been extracted, the Cash balance in the corresponding ~Account~ is altered accordingly and/or Orders are created. When allocating a CAMT transaction amount, the rules are used:
- Is the source BankAccount connected to the InvestorAccount?
- Is the transaction amount between the minimum and maximum allowed transaction amount?
- Does the description of the CAMT file contain one and only one investor account number? If not, do not allocate.
- In which Asset does the transaction amount have to be invested? The CAMT file description can mention multiple Asset identifiers such as the Asset’s name, the ISIN code, an external code (a PF code) or a banking statement code.
Relevant endpoints
- GET /CAMTFiles/{labelId}
- POST /CAMTFileAdd
- GET /Transactions/{labelId}
- PUT /TransactionUpdate
- PUT /TransactionRefund
SEPA
Definition
The Single Euro Payments Area (SEPA) is a payment-integration initiative of the European Union for simplification of bank transfers denominated in euro.
SEPATransaction
Definition
A SEPATransaction represents an outgoing payment from a CashLedger that has its ‘AllowPayout’ property set to ‘true’ to a certain BankAccount. It can be created in one of multiple ways:
- By the Label from either a LabelLedger or an InvestorAccount Label to whichever BankAccount
- By the Label as a refund from an unallocated ~CAMTTransaction~ back to the BankAccounts where the CAMT Entries came from
- By a User from their main CashLedger to whichever BankAccount.
Relevant endpoints
- GET /SEPATransactions/{labelId}
- POST /SEPAExport/{labelId}
- POST /sepatransactionadd
- PUT /CancelSEPATransaction/{labelId}/{id}
DirectDebit
Definition
A DirectDebit is an instruction from you to your bank. It authorizes the organization you want to pay to collect varying amounts from your bank account – but only if you’ve been given advance notice of the amounts and dates of collection. Once you have agreed to those, the money is deducted automatically.
DirectDebitContract
Definition
In a DirectDebitContract, all the necessary information concerning a DirectDebit is specified. This information contains the IBAN of the BankAccount from which the money should be taken, the instructed amount, the direct debit recurrence and deadline, etc.
Relevant endpoints
- GET /DirectDebitContracts/{labelId}
- GET /DirectDebitContractGetById/{labelId}/{directDebitContractId}
- POST /DirectDebitContractAdd
- PUT /DirectDebitContractUpdate
SEPADirectDebit
Definition
SEPADirectDebit is a payment instrument for initiating domestic and cross-border collections uniformly in euros throughout all SEPA countries.
DirectDebitSepaFile
Definition
A DirectDebitSepaFile represents the content of an XML file for SEPADirectDebit. These XML files have a standardized format as published by ISO standard ISO20022.
DirectDebitSepaBatch
Definition
A DirectDebitSepaFile contains one or more DirectDebitSepaBatches. In each of these batches, a series of money collections is specified.
DirectDebitSepaRecord
Definition
A DirectDebitSepaBatch contains a DirectDebitSepaRecord for each individual scheduled collection of money.