Post Bank Transactions
POST
/public/v3/customers/{customer_id}/transaction_collections
Creates bank Account Transactions. You need to create Bank Accounts before using this endpoint. You can submit up to 100 000 transactions at once. Transactions has to have unique external_transaction_id.
Please obtain the right bank_slug from Banks endpoint
| Parameter | Data type | Required? | Description |
|---|---|---|---|
| customer_id | string | yes | Customer ID |
none
| Parameter | Data type | Required? | Description |
|---|---|---|---|
| transactions | Array | yes | Array of transactions |
| external_transaction_id | string | yes | Transaction ID from the original data source. Must be unique for associated user and account. |
| name | string | yes | Transaction name/description |
| type | string | no | Transaction type, if available |
| amount | float | yes | Amount (positive for income and negative for expenditure) |
| balance | Balance | no | Balance object |
| currency | string | yes | Currency code (compatible with ISO 4217) |
| status | enum | yes | Allowed:(Booked, Pending) |
| bank_slug | string | yes | Slug of the associated bank |
| account_number | string | yes | Number of the associated account |
| category | string | no | Category of the transaction |
| address_line | string | no | Address line |
| value_date_time | integer | yes | Timestamp |
| booking_date_time | integer | yes | Timestamp |
| Parameter | Data type | Required? | Description |
|---|---|---|---|
| amount | float | yes | Amount (positive for income and negative for expenditure) |
| currency | string | yes | Currency code (compatible with ISO 4217) |
| type | enum | yes | Allowed:(ClosingAvailable, ClosingBooked, ClosingCleared, Expected, ForwardAvailable, Information, InterimAvailable, InterimBooked, InterimCleared, OpeningAvailable, OpeningBooked, OpeningCleared, PreviouslyClosedBooked) |
| Parameter | Data type | Required? | Description |
|---|---|---|---|
| success | string | yes | Additional information about save status |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
curl --location --request POST 'https://api.friendlyscore.com/public/v3/customers/123/transaction_collections'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'
--data-raw '{
"transactions": [
{
"external_transaction_id": "958d14298-91ee-405d-89da-248c30eaf0e81-booked",
"name": "TFL TRAVEL ON 25 NOV Booked",
"type": "",
"amount": -255,
"currency": "GBP",
"status": "Booked",
"bank_slug": "barclays",
"account_number": "123-123-123-123",
"balance": {
"amount": -105,
"currency": "GBP",
"type": "ClosingAvailable"
},
"booking_date_time": 1574672448
}]
}'1
2
3
{
"status": "success"
}Was this article helpful?
Friendly Score UK Ltd.
84 Brook Street
London W1K 5EH
Call us on +44 20 3709 6726
Company registered in England
Company number 09168668, ICO ZA111687
VAT registration number 206 9758 80
Authorised and Regulated by the Financial Conduct Authority. (FRN: 821100, 781963)