/api/v2/server-side-api/vc/transactions/ Liệt kê các giao dịch tiền tệ ảo
Trả về lịch sử giao dịch tiền tệ ảo cho một hồ sơ người dùng, mới nhất trước. Kết quả sử dụng phân trang con trỏ: khi response bao gồm pagination.next_cursor khác null, hãy truyền lại nó làm tham số truy vấn cursor để lấy trang tiếp theo.
Query parameters
Lọc lịch sử theo một mã tiền tệ ảo duy nhất.
Con trỏ phân trang mờ được trả về dưới dạng pagination.next_cursor trong response trước đó. Bỏ qua để lấy trang đầu tiên.
Số lượng giao dịch tối đa trả về mỗi trang. Mặc định là 50.
Header parameters
ID duy nhất của khách hàng trong hệ thống của bạn. Cần có adapty-customer-user-id hoặc adapty-profile-id.
ID duy nhất của hồ sơ người dùng trong hệ thống của bạn. Lựa chọn tốt nhất nếu bạn đang làm việc với các hồ sơ ẩn danh. Cần có adapty-customer-user-id hoặc adapty-profile-id.
Responses
Lịch sử giao dịch được trả về thành công
Schema
Danh sách phân trang các giao dịch tiền tệ ảo cho một hồ sơ người dùng.
ID duy nhất của giao dịch.
Nguồn gốc của giao dịch. Một trong các giá trị: store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund, hoặc expiry.
Thay đổi số dư theo từng loại tiền tệ được ghi lại trong giao dịch này.
Mã tiền tệ ảo.
Thay đổi có dấu được áp dụng vào số dư. Giá trị dương là khoản ghi có, giá trị âm là khoản ghi nợ.
Số dư tiền tệ sau khi giao dịch này được áp dụng.
Các cặp khóa-giá trị được lưu trữ cùng với giao dịch, nếu có.
Thời điểm giao dịch được ghi lại.
Con trỏ không rõ ràng cho trang tiếp theo. Truyền nó dưới dạng tham số truy vấn cursor để tải thêm kết quả. Null khi không còn trang nào nữa.
Example
{
"data": [
{
"transaction_id": "0190e8a4-1c2b-7def-8abc-2c1a4b6d8e90",
"transaction_type": "api_transaction",
"items": [
{
"currency_code": "COINS",
"amount": 500,
"balance_after": 12950
}
],
"metadata": {
"reason": "promo_bonus"
},
"created_at": "2026-05-23T10:30:00Z"
},
{
"transaction_id": "0190e7b2-9a44-7c10-bb31-7d2e9f0a1c55",
"transaction_type": "store_purchase",
"items": [
{
"currency_code": "COINS",
"amount": 1000,
"balance_after": 12450
}
],
"created_at": "2026-05-22T18:05:12Z"
},
{
"transaction_id": "0190e5c0-3f18-7b9a-9e6d-44a1c8b27e03",
"transaction_type": "subscription_renewal",
"items": [
{
"currency_code": "GEMS",
"amount": 200,
"balance_after": 3280
}
],
"created_at": "2026-05-20T09:00:00Z"
}
],
"pagination": {
"next_cursor": "MjAyNi0wNS0yMFQwOTowMDowMFowMTkwZTVjMC0zZjE4LTdiOWEtOWU2ZC00NGExYzhiMjdlMDM="
}
}Yêu cầu không hợp lệ. Giá trị cursor không hợp lệ (error_code là invalid_cursor).
Schema
Nguồn gốc của lỗi
Mảng các thông báo lỗi
Tên lỗi rút gọn
Mã trạng thái HTTP
Không được phép. API key bị thiếu hoặc không hợp lệ.
Schema
Nguồn gốc của lỗi
Mảng các thông báo lỗi
Tên lỗi rút gọn
Mã trạng thái HTTP
Bị từ chối. Server API cho tiền tệ ảo chưa được kích hoạt cho ứng dụng này.
Schema
Nguồn gốc của lỗi
Mảng các thông báo lỗi
Tên lỗi rút gọn
Mã trạng thái HTTP
Không tìm thấy hồ sơ người dùng.
Schema
Nguồn gốc của lỗi
Mảng các thông báo lỗi
Tên lỗi rút gọn
Mã trạng thái HTTP
Lỗi máy chủ nội bộ