---
description: Dùng để lấy một hoặc nhiều giao dịch ngân hàng
---

# API lấy giao dịch

### Trước khi bắt đầu

Một số lưu ý trước khi bắt đầu với các API liên quan tới webhook:

* Một tài khoản [Casso](https://my.casso.vn) đã liên kết một tài khoản ngân hàng. Để test với API này **có thể** sử dụng [tài khoản demo.](broken-reference)
* Bạn cần có [API Key](../chung-thuc/tao-api-key-thu-cong) hoặc [Access token từ Oauth 2.0 của Casso](../chung-thuc/tich-hop-oauth2) để thiết lập ở trường Authorization HTTP Header.

## &#x20;Lấy giao dịch ngân hàng &#x20;

<mark style="color:blue;">`GET`</mark> `https://oauth.casso.vn/v2/transactions`

API này cho phép lấy toàn bộ thông tin giao dịch ngân hàng.

#### Query Parameters

| Name      | Type    | Description                                                                               |
| --------- | ------- | ----------------------------------------------------------------------------------------- |
| sort      | string  |  Sắp xếp tăng hoặc giảm dần dựa theo thời gian của giao dịch. Mặc định là ASC(tăng dần).  |
| pageSize  | string  |  Số lượng giao dịch trên một trang                                                        |
| page      | integer |  Số thứ tự của trang                                                                      |
| fromDate  | string  |  Lấy giao dịch bắt đầu từ ngày. Định dạng: YYYY-MM-                                       |

#### Headers

| Name          | Type   | Description                                                               |
| ------------- | ------ | ------------------------------------------------------------------------- |
| Authorization | string | `Bearer <"access token từ Oauth2">` **hoặc** `Apikey <"API key của bạn">` |

{% tabs %}
{% tab title="200 Response chi tiết các giao dịch ngân hàng" %}
{% tabs %}
{% tab title="Response theo page" %}
```
{
    "error": 0,
    "message": "success",
    "data": {
        "page": 4,
        "pageSize": 10,
        "nextPage": 5,
        "prevPage": 3,
        "totalPages": 35,
        "totalRecords": 341,
        "records": [
            {
                "id": 5789,
                "tid": "TF2104152395814062",
                "description": "Khanhnm chuyen tien",
                "amount": -193000,
                "cusum_balance": 1070904,
                "when": "2021-04-15"
            },
            {
                "id": 5790,
                "tid": "TF2104152997602811",
                "description": "Chuyen tien nap momo",
                "amount": -350000,
                "cusum_balance": 720904,
                "when": "2021-04-15"
            },
        ]
    }
}
```
{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="401 Access-Token không đúng hoặc đã hết hạ" %}
```
```
{% endtab %}
{% endtabs %}

#### Chi tiết các tham số

| Tham số         | Mô tả                                                                                    | Gá trị mặc định  |
| --------------- | ---------------------------------------------------------------------------------------- | ---------------- |
| _**fromDate**_  | Thời gian bắt đầu bạn muốn lấy giao                                                     | 7 ngày gần nhất  |
| _**page**_      | Số thứ tự trang                                                                          | 1                |
| _**pageSize**_  | Số giao dịch trên một trang                                                              | 10               |
| _**sort**_      | Sắp xếp giao dịch, các giá trị gồm: ASC, DESC. Với ASC là tăng dần còn DESC là giảm dần. | ASC              |

{% hint style="info" %}
Nếu tham số nào không tồn tại thì sẽ lấy giá trị mặc định.
{% endhint %}

#### Ví dụ:&#x20;

{% tabs %}
{% tab title="CURL" %}
```javascript
curl --location --request GET 'https://oauth.casso.vn/v2/transactions?fromDate=2021-04-01&page=4&pageSize=20&sort=ASC' \
--header 'Authorization: Apikey <"API Key của bạn"> hoặc Bearer <"access token từ OAuth2">'
```
{% endtab %}

{% tab title="PHP" %}
```php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://oauth.casso.vn/v2/transactions?fromDate=2021-04-01&page=4&pageSize=20&sort=ASC",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Apikey <"API Key của bạn"> hoặc Bearer <"access token từ OAuth2">",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);
```
{% endtab %}

{% tab title="JAVA" %}
```java
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://oauth.casso.vn/v2/transactions?fromDate=2021-04-01&page=4&pageSize=20&sort=ASC")
  .get()
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Apikey <"API Key của bạn"> hoặc Bearer <"access token từ OAuth2">")
  .build();

Response response = client.newCall(request).execute();
```
{% endtab %}
{% endtabs %}

## Lấy chi tiết một giao dịch

<mark style="color:blue;">`GET`</mark> `https://oauth.casso.vn/v2/transactions/:id`

API cho phép bạn xem chi tiết của một giao dịch ngân hàng.

#### Path Parameters

| Name | Type   | Description                           |
| ---- | ------ | ------------------------------------- |
| id   | number | ID của giao dịch trên hệ thống Casso  |

#### Headers

| Name          | Type   | Description                                                |
| ------------- | ------ | ---------------------------------------------------------- |
| Authorization | string | `Bearer` + `access token nhận được từ OAuth 2.0 của Casso` |

{% tabs %}
{% tab title="200 Thông tin chi tiết của 1 giao dịch" %}
```
{
    "error": 0,
    "message": "success",
    "data": {
        "id": 314344,
        "tid": "TF210702253136879",
        "description": "DH220",
        "amount": -10000,
        "cusumBalance": 389460,
        "when": "2021-07-02T12:50:00",
        "bankSubAccId": "8007041023848"
    }
}
```
{% endtab %}

{% tab title="401 " %}
```
{
    "error": 401,
    "message": "Unauthorized Access",
    "data": null
}
```
{% endtab %}
{% endtabs %}

#### Ví dụ:&#x20;

{% tabs %}
{% tab title="CURL" %}
```javascript
curl --location --request GET 'https://oauth.casso.vn/v2/transactions/123 \
--header 'Authorization: Apikey <"API Key của bạn"> hoặc Bearer <"access token từ OAuth2"'
```
{% endtab %}

{% tab title="PHP" %}
```php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://oauth.casso.vn/v2/transactions/12",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Apikey <"API Key của bạn"> hoặc Bearer <"access token từ OAuth2">",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);
```
{% endtab %}

{% tab title="JAVA" %}
```java
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://oauth.casso.vn/v2/transactions/12")
  .get()
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Apikey <"API Key của bạn"> hoặc Bearer <"access token từ OAuth2">")
  .build();

Response response = client.newCall(request).execute();
```
{% endtab %}
{% endtabs %}

