API Cake by VPBank: tài liệu lấy lịch sử giao dịch

CAKE API

Tích hợp giao dịch Cake by VPBank

API Cake cung cấp giao dịch tài khoản số để tích hợp thanh toán và cộng số dư tự động. Kết nối này phù hợp cho dịch vụ số, creator, cửa hàng online và ứng dụng quy mô nhỏ.

Phương thứcGET

Định dạngJSON

Xác thựcToken

Phiên bảnV2

Tài liệu API theo phiên bản

Chọn phiên bản tương ứng trong trang quản lý tài khoản Cake by VPBank để xem tham số và dữ liệu trả về.

GETV2Khuyên dùng

https://thueapibank.vn/historyapicakev2/YOUR_TOKEN

Tham số cần thiết

Tham số	Bắt buộc	Mô tả
`YOUR_TOKEN`	Có	Token API được cấp trong trang quản lý.

Code mẫu

curl --request GET \
  "https://thueapibank.vn/historyapicakev2/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapicakev2/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapicakev2/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

Response mẫu

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "type": "IN",
      "transactionID": "FT26091912345678",
      "amount": 450000,
      "description": "DH1024 THANH TOAN",
      "transactionDate": "2026-09-19 10:24:36"
    }
  ]
}

Response thực tế có thể bổ sung trường riêng của Cake by VPBank. Luôn kiểm tra trường tồn tại trước khi đọc.

Luồng xử lý khuyến nghị

1
Lưu mã giao dịch
Dùng transactionID làm khóa chống xử lý trùng.
2
Chỉ xử lý tiền vào
Kiểm tra type === "IN" trước khi ghép đơn.
3
Ghép đúng đơn hàng
So khớp số tiền và mã đơn trong nội dung chuyển khoản.
4
Đối soát lại
Chạy tác vụ định kỳ để bù các webhook bị chậm hoặc thất bại.

Câu hỏi về API Cake by VPBank

API Cake by VPBank dùng để làm gì?

API giúp lấy dữ liệu giao dịch Cake by VPBank dạng JSON để xác nhận chuyển khoản, cộng số dư và đối soát tự động.

Nên dùng phiên bản API nào?

Nên ưu tiên phiên bản mới nhất mà tài khoản của bạn đang hỗ trợ. V1 và V2 phù hợp tích hợp bằng token; V3 bổ sung thông tin tài khoản trong đường dẫn.

Có thể nhận giao dịch Cake by VPBank qua webhook không?

Có. Sau khi thêm tài khoản, bạn có thể cấu hình URL webhook để hệ thống gửi sự kiện giao dịch mới về máy chủ của bạn.

API Cake by VPBank