Direct Bank Transactions

Open Ledger offers a Transaction API that allows for direct manipulation of transaction data within your application. This setup provides an alternative to third-party integrations like Plaid, offering greater control over how transactions are processed and managed.

Importing transactions via API

Ensure you have the required API credentials, which include client_id and client_secret, necessary for authenticating requests to the API.

Utilize the following endpoints to manage transactions for a specific company:

Adding a Transaction

To add a transaction to a specific company, send a POST request with the transaction details:

$
POST /api/company/{id}/transactions
>
Authorization: Bearer {access_token}
>
Content-Type: application/json
>
>
{
>
  "date": "2024-01-15",
>
  "description": "Invoice payment received",
>
  "amount": 500,
>
  "currency": "USD",
>
  "category": "Income",
>
  "accountId": "acc_123456"
>
}

Replace {id} with the actual company ID to which the transaction belongs.

1
{
2
  "success": true,
3
  "message": "Transaction added successfully",
4
  "data": {
5
    "transactionId": "txn_123456",
6
    "date": "2024-01-15",
7
    "description": "Invoice payment received",
8
    "amount": 500,
9
    "currency": "USD",
10
    "category": "Income",
11
    "accountId": "acc_123456"
12
  }
13
}

Error Response

1
{
2
  "success": false,
3
  "message": "Error adding transaction: [Error Detail]"
4
}

Best Practices

• Validate data on the client side before submitting it to ensure it meets API requirements and enhances user experience.
• Implement robust error handling to manage API request failures gracefully.
• Secure all communications with the API using HTTPS to protect sensitive financial data.