Casso Developer
stable (v2)
stable (v2)
  • Tổng quan
  • Kết nối Casso bằng Webhook
    • Thiết lập Webhook thủ công
    • Xử lý sự kiện Webhook
  • Sử dụng API Casso
    • Chứng thực API
      • Tạo API Key thủ công
    • Danh sách API
      • API lấy thông tin user
      • API thiết lập webhook
      • API lấy giao dịch
      • API lấy thông tin tài khoản ngân hàng
      • API buộc đồng bộ giao dịch mới ngay
  • Tài nguyên khác
    • Tích hợp xác nhận thanh toán
    • Change log
Powered by GitBook
On this page
  • Trước khi bắt đầu
  • Đồng bộ giao dịch mới

Was this helpful?

  1. Sử dụng API Casso
  2. Danh sách API

API buộc đồng bộ giao dịch mới ngay

Thay vì phải chờ hệ thống của Casso tự động đồng bộ giao dịch mới thì với API này sẽ giúp bạn xử lý các giao dịch mới mà hệ thống của Casso chưa đồng bộ kịp thời.

PreviousAPI lấy thông tin tài khoản ngân hàngNextTích hợp xác nhận thanh toán

Last updated 3 months ago

Was this helpful?

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 đã liên kết một tài khoản ngân hàng. Để test với API này hạn chế sử dụng tài khoản demo.

  • Bạn cần có để thiết lập ở trường Authorization HTTP Header.

Đồng bộ giao dịch mới

POST https://oauth.casso.vn/v2/sync

Đồng bộ giao dịch mới tương ứng với số tài khoản của bạn trong business

Headers

Name
Type
Description

Authorization*

string

Bearer <access token từ Oauth2> hoặc Apikey <API key của bạn>

Request Body

Name
Type
Description

bank_acc_id*

string

Số tài khoản ngân hàng của bạn liên kết trên hệ thống của Casso

{
    "error": 0,
    "message": "success",
    "data": null
}
{
    "error": 401,
    "message": "Unauthorized Access",
    "data": null
}
{
    "error": 429,
    "message": "Doanh nghiệp của bạn đang gọi Đồng bộ quá nhiều, giới hạn mặc định 1 Tài khoản ngân hàng/request/phút. Ngoài ra, dựa vào gói dịch vụ đang sử dụng của doanh nghiệp để tính giới hạn số lượng yêu cầu trong 1 ngày. Liên hệ với chúng tôi qua https://casso.vn nếu như bạn muốn tăng số lượng yêu cầu trong ngày.",
    "data": null
}

Ví dụ:

curl --location --request POST 'https://oauth.casso.vn/v2/sync' \
--header 'Authorization: Bearer <"Access token nhận được từ OAuth 2.0 của Casso">' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bank_acc_id": "Số tài khoản ngân hàng cần đồng bộ"
}'
$curl = curl_init();

$data = array(
  'bank_acc_id' => 'Số tài khoản ngân hàng cần đồng bộ',
);
$postdata = json_encode($data);

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://oauth.casso.vn/v2/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => $postdata),
  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);
OkHttpClient client = new OkHttpClient();

RequestBody formBody = new FormBody.Builder()
  .add("bank_acc_id", "Số tài khoản ngân hàng cần đồng bộ")
  .build();

Request request = new Request.Builder()
  .url("https://oauth.casso.vn/v2/sync")
  .post(formBody)
  .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();

Lưu ý về giới hạn gọi Đồng bộ của một TK ngân hàng:

  • Chỉ gọi 1 yêu cầu/1 phút.

  • Dựa vào gói Doanh nghiệp đang sử dụng để tính số lượng yêu cầu trong ngày.

  • Tài khoản ngân hàng MBBank BIZ (RPA) chỉ gọi 1 yêu cầu/15 phút

Sau khi bạn gọi API này, nếu hệ thống của Casso phát hiện có một hoặc nhiều giao dịch mới được đồng bộ thì ngay lúc đó hệ thống của Casso sẽ đẩy một Event chứa các giao dịch mới đó tới .

Casso
API Key
Webhook của bạn đã thiết lập