# API tải thông tin giao dịch

##  Lấy thông tin giao dịch ngân hàng  

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

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

#### 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  | Kích thước của trang                                                                    |
| page     | integer | Số thứ tự 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 | Access-Token |

{% tabs %}
{% tab title="200 Response chi tiết các giao dịch ngân hàng" %}
{% tabs %}
{% tab title="Response giao dịch" %}

```
{
    "error": 0,
    "message": "success",
    "data": [
        {
            "id": 3267,
            "tid": "TF210403249039850",
            "description": "refund",
            "amount": 70000000,
            "cusum_balance": 7303904,
            "when": "2021-04-03"
        },
        {
            "id": 3268,
            "tid": "TF210403249040659",
            "description": "chuyen tien tro T4",
            "amount": 1767000,
            "cusum_balance": 5536904,
            "when": "2021-04-03"
        },
    ]
}
```

{% endtab %}

{% 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": "TF210415239581402",
                "description": "chuyen tien",
                "amount": -193000,
                "cusum_balance": 1070904,
                "when": "2021-04-15"
            },
            {
                "id": 5790,
                "tid": "TF210415299602811",
                "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ạn" %}

```
{
    "error": 401,
    "message": "Unauthorized Access",
    "data": null
}
```

{% 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ố item 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 %}

```
curl --location --request GET 'https://oauth.casso.vn/v1/transactions?fromDate=2021-04-01&page=4&pageSize=20&sort=ASC' \
--header 'Authorization: Access token'
```

## Lấy chi tiết thông tin giao dịch theo id giao dịch

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

#### Path Parameters

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

#### Headers

| Name          | Type   | Description  |
| ------------- | ------ | ------------ |
| Authorization | string | Access-Token |

{% 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-02",
        "bankSubAccId": "8007041023848"
    }
}
```

{% endtab %}

{% tab title="401 " %}

```
{
    "error": 401,
    "message": "Unauthorized Access",
    "data": null
}
```

{% endtab %}
{% endtabs %}

```
curl --location --request GET 'https://oauth.casso.vn/v1/transactions/123 \
--header 'Authorization: Access token'
```