Transaction Upload
You can update an account balance at anytime with a Transaction Upload. This is essential to keep your customers up to date on a regular basis which helps avoiding disputes and contributes significantly to collections performance.
info
Download a sample file with a variety of transactions.
Filename convention: YYYY-MM-DD-hh-mm-ss.csv
| Header | Format | Description |
|---|---|---|
| AccountRef* | String | Same value as you have provided in the Account Upload which represents the account in your system. |
| TransactionRef | String | Unique value representing the transaction in your system. This value helps identifying and troubleshooting your transactions in our system. |
| TransactionType* | Constant, e.g. Charge | This value determines the purpose and arithmetic operator of the transaction. See all Transaction Types below. |
| Amount* | Integer representing a monetary value in cents, e.g. 100 means $1.00 | Amount to be applied to the corresponding account Balance. This value must be greater than zero. |
| ProcessedAt* | String time formatted as per RFC 3339, e.g. 2021-01-30 21:37:42 | Date and time when the transaction was processed. Must be on the same day or later than the corresponding account referral date. |
| EffectiveDate | String date formatted as YYYY-MM-DD, e.g. 2021-01-15 | Calendar date that the transaction is effective from, in your local timezone (not UTC). Required for Instalment transactions — it records the original contractual due date of the overdue instalment. Optional for other transaction types. Must not be in the future. |
| Description | String | Contextual information for this transaction such as the reason for charging fees or payment reference number. |
Transaction Types
| Type | Description |
|---|---|
Charge | Used for charging customers. For example, accrued interest or fees. This will increase the account balance. |
Chargeback | Used for indicating that you have received a chargeback (i.e. payment dispute/reversal) from the customer after submitting a payment transaction to InDebted. This will offset the initial balance, any previous Payment transactions submitted by you to InDebted. |
Compensation | Used for compensating customers. For example, waiving fees after a dispute resolution. This will decrease the account balance. |
Instalment | Used for posting an overdue instalment on a pre-charge-off account. This will increase the account balance. Requires EffectiveDate to record the original contractual due date of the instalment. |
Payment | Used for indicating that you have received a payment directly from the customer. This will decrease the account balance. |