GET/service/@id/tinopay/pay-codes

Cấu trúc mã thanh toán

Mẫu TinoPay dùng để trích code từ nội dung chuyển khoản (field code của webhook), cũng là tiền tố mã đơn của tích hợp Sapo. Trả [{prefix, suffix_from, suffix_to, character_type}]; ví dụ DH + 6–8 chữ số: nội dung DH123456 thanh toan cho mã DH123456.

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ên	Kiểu	Yêu cầu	Mô tả
`id`	int	Bắt buộc	ID dịch vụ TinoPay

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ỗi	Mô tả
`404 · service_not_found, invalid method`	Dị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_active`	Dịch vụ không ở trạng thái Active hoặc Suspended.
`403 · MERCHANT_SUSPENDED`	Merchant đang tạm ngưng: chặn thao tác ghi, GET vẫn dùng được.
`404 · RESOURCE_NOT_FOUND`	Tài nguyên không có hoặc không thuộc merchant.
`422 · VALIDATION_FAILED`	Dữ liệu sai; details liệt kê theo trường.
`502 · NETWORK_ERROR…, 504`	Kế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.