# 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.](https://developer.casso.vn/english-v2-new/casso-api/api/broken-reference) * Bạn cần có [API Key](https://developer.casso.vn/english-v2-new/casso-api/chung-thuc/tao-api-key-thu-cong) hoặc [Access token từ Oauth 2.0 của Casso](https://developer.casso.vn/english-v2-new/casso-api/chung-thuc/tich-hop-oauth2) để thiết lập ở trường Authorization HTTP Header. ## Lấy giao dịch ngân hàng `GET` `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ụ: {% 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 `GET` `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ụ: {% 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 %}