Tino Developers
GET/service/@id/tinopay/sapo-order-logs

Nhật ký đối soát Sapo

Giao dịch đối chiếu với đơn Sapo. Query: integration_id, transaction_id, status, page, per_page. status: paid (đã ghi nhận; message ghi số tiền dư nếu có), underpaid (chuyển thiếu, chưa ghi nhận), already_paid (đơn đã thanh toán trước đó), not_found (không thấy đơn theo mã trong nội dung chuyển khoản), cancelled (đơn đã huỷ), error (Sapo từ chối hoặc không kết nối được, xem message). Đối soát lại một giao dịch: gửi lại webhook của giao dịch; đơn đã thanh toán không bị ghi nhận trùng.

API merchant · Cập nhật 22/10/2026Xem .md

Route của dịch vụ TinoPay: gọi bằng token đăng nhập của chủ dịch vụ; gateway /v1 (token ứng dụng, token cá nhân) chưa mở TinoPay. Xem Bắt đầu với TinoPay.

Xác thực

Gửi token trong header Authorization:

Authorization: Bearer <token>

Token gọi được: token đăng nhập của chủ dịch vụ TinoPay (token khu vực khách hàng tino.vn).

Tham số

Tham số đường dẫn

TênKiểuYêu cầuMô tả
idintBắt buộcID dịch vụ TinoPay

Query

TênKiểuYêu cầuMô tả
integration_idint——
transaction_idint——
statusstring——
pageint——
per_pageint——

Phản hồi

Mẫu dựng theo tài liệu TinoPay API v1 (Tino chuyển tiếp nguyên dữ liệu TinoPay), giá trị là ví dụ.

Mã lỗi

Mã lỗiMô tả
404 · service_not_found, invalid methodDịch vụ không phải của tài khoản đang đăng nhập, hoặc không phải TinoPay.
403 · service_not_activeDịch vụ không ở trạng thái Active hoặc Suspended.
403 · MERCHANT_SUSPENDEDMerchant đang tạm ngưng: chặn thao tác ghi, GET vẫn dùng được.
404 · RESOURCE_NOT_FOUNDTài nguyên không có hoặc không thuộc merchant.
422 · VALIDATION_FAILEDDữ liệu sai; details liệt kê theo trường.
502 · NETWORK_ERROR…, 504Kết nối giữa Tino và đối tác gián đoạn (504: body HTML, request quá lâu): lỗi phía Tino, không phải lỗi token. Đừng xoá token, thử lại sau.

Lỗi có dạng {"error": ["<CODE>"], "message", "details", "request_id"}; mọi mã lỗi ở Bắt đầu với TinoPay.