Open API error codes
How to read the response
Every TINGEE API returns HTTP status 200, even when an error occurs. Use the code field in the body to determine the result:
{
"code": "97",
"message": "Invalid signature",
"data": null
}
code = "00": Success; the data is indata.codeother than"00": Failure. Look up the meaning in the tables below;messagedescribes the cause in detail.
System error codes
These error codes are returned during request authentication, before any business processing, and apply to all APIs.
| Error code | Message | Cause & How to handle |
|---|---|---|
00 | Success | Success. |
90 | Timestamp is not in correct format. | The x-request-timestamp header is not in the yyyyMMddHHmmssSSS format (17 characters, UTC+7). |
91 | Invalid request timestamp. / Request expired. | x-request-timestamp is too far from the TINGEE server time: more than 90 seconds ahead or more than 11 minutes behind. Check your system clock sync (NTP) and time zone. |
92 | Không tìm thấy clientId / Không tìm thấy Merchant | x-client-id does not exist, has been disabled, or is not attached to a Merchant. Check the details on the API Key management page. |
94 | x-request-id must be a UUID v4. | The x-request-id header (optional) was sent but is not a valid UUID v4. |
97 | Invalid signature | The x-signature signature does not match. Check your Secret Key and the signed string {x-request-timestamp}:{JSON body}. See How to generate the signature. |
97 | Duplicate request. | The request has the same signature as a previously sent request (within 12 minutes). Generate a new x-request-timestamp and signature for every API call. |
99 | Error | Unknown error. Contact TINGEE with the request details. |
400 | (Details in message) | Invalid input data (missing required fields, wrong data types...). message lists the invalid fields. Some validation errors are returned as business codes 1005 or 1006. |
402 | Không đủ số dư | The Merchant's service account balance on TINGEE is insufficient for the request. Top up your balance and try again. |
500 | Internal Server Error | System error. Try again later or contact TINGEE. |
API rate limit
Each API allows at most 20 requests per 10 seconds per IP address. When you exceed the limit, the system returns error code 1001 (Thao tác quá nhanh).
Business error codes
| Error code | Message (returned by the API) | Meaning |
|---|---|---|
| 1001 | Thao tác quá nhanh | Too many requests in a short time |
| 1002 | Không tìm thấy thông tin | Information not found |
| 1003 | Dữ liệu không tồn tại | Data does not exist |
| 1004 | Không có quyền truy cập | Access denied |
| 1005 | Không được để trống trường dữ liệu | A data field must not be empty |
| 1006 | Dữ liệu không hợp lệ | Invalid data |
| 1007 | Tài khoản đã bị khóa | Account is locked |
| 1008 | Tài khoản không tồn tại trên hệ thống | Account does not exist in the system |
| 1009 | Không tìm thấy Merchant | Merchant not found |
| 1010 | Không tìm thấy STK ảo được liên kết với Merchant | No virtual account linked to the Merchant was found |
| 1011 | Số tài khoản không tồn tại hoặc đã được kích hoạt nhận BĐSD | Account number does not exist or is already activated for balance notifications |
| 1012 | Không được để trống Mã giới thiệu | Referral code must not be empty |
| 1013 | BankConfig không tồn tại | BankConfig does not exist |
| 1014 | Config OCB chưa được thiết lập | OCB config has not been set up |
| 1015 | Config VIB chưa được thiết lập | VIB config has not been set up |
| 1016 | Config CTG chưa được thiết lập | CTG config has not been set up |
| 1017 | Config STB chưa được thiết lập | STB config has not been set up |
| 1018 | QRCode động chưa được hỗ trợ | Dynamic QR code is not supported yet |
| 1019 | QRCode động chưa được thiết lập | Dynamic QR code has not been set up |
| 1020 | Mã QRCode chưa được khai báo | QR code has not been registered |
| 1021 | Không tìm thấy ngân hàng | Bank not found |
| 1022 | QR đã được gắn với STK của Merchant | QR is already attached to a Merchant account number |
| 1023 | Số tài khoản ảo không hợp lệ | Invalid virtual account number |
| 1024 | Số tài khoản ảo không tồn tại | Virtual account number does not exist |
| 1025 | Số tài khoản không được phép liên kết với thiết bị | Account number is not allowed to be linked to the device |
| 1026 | Mã giới thiệu không tồn tại | Referral code does not exist |
| 1027 | Tài khoản không tồn tại trong hệ thống | Account does not exist in the system |
| 1028 | Không tìm thấy thiết bị | Device not found |
| 1029 | Không tìm thấy vai trò | Role not found |
| 1030 | Không tìm thấy thông tin giao dịch | Transaction information not found |
| 1031 | Không tìm thấy cửa hàng | Shop not found |
| 1032 | Không tìm thấy cửa hàng được gắn với nhân viên | No shop assigned to the staff member was found |
| 1033 | Gói dịch vụ đã hết hạn | Service plan has expired |
| 1034 | Bạn không thể đăng nhập, vui lòng liên hệ quản trị viên | You cannot log in; please contact the administrator |
| 1035 | Thông tin đăng nhập không đúng! | Incorrect login credentials |
| 1036 | Mã giới thiệu không được để trống | Referral code must not be empty |
| 1037 | Các Tingee Box khác ngân hàng không được liên kết cùng một cửa hàng | Tingee Boxes of different banks cannot be linked to the same shop |
| 1038 | Cửa hàng đã có thiết bị khóa theo ngân hàng khác, không thể thêm thiết bị khóa theo ngân hàng hiện tại | The shop already has a device locked to another bank; a device locked to the current bank cannot be added |
| 1039 | Không liên kết được với thiết bị. Vui lòng thử lại sau | Could not link to the device. Please try again later |
| 1040 | Không tạo được QRCode | Could not create the QR code |
| 1041 | Ngân hàng chưa được hỗ trợ | Bank is not supported yet |
| 1042 | Không tìm thấy clientId | clientId not found |
| 1043 | Số tài khoản không đúng | Incorrect account number |
| 1044 | Mã thiết bị không hợp lệ | Invalid device code |
| 1045 | Số tài khoản ảo không hợp lệ | Invalid virtual account number |
| 1046 | VA Prefix đã tồn tại | VA prefix already exists |
| 1047 | Không tìm thấy Số tài khoản ảo | Virtual account number not found |
| 1048 | Số tài khoản ảo đã tồn tại trong hệ thống | Virtual account number already exists in the system |
| 1049 | Doanh nghiệp/Hộ KD đã liên kết STK gốc hoặc đã tạo STK ảo(VA) | The business / household business has already linked an original account number or created a virtual account (VA) |
| 1050 | Doanh nghiệp/ Hộ KD hiện tại không được phép sử dụng Ngân hàng đã được liên kết với thiết bị này | The current business / household business is not allowed to use the bank linked to this device |
| 1051 | Doanh nghiệp/ Hộ KD không được phép liên kết tài khoản thuộc Ngân hàng này | The business / household business is not allowed to link accounts of this bank |
| 1052 | Loại thiết bị đã tồn tại | Device type already exists |
| 1053 | Không tìm thấy loại thiết bị này | Device type not found |
| 1054 | Loại thiết bị không thể liên kết trên ứng dụng này | This device type cannot be linked in this application |
| 1055 | Thiết bị đã được liên kết với Doanh nghiệp/Hộ KD khác | Device is already linked to another business / household business |
| 1056 | MerchantId không hợp lệ | Invalid MerchantId |
| 1057 | Không tìm thấy thông tin tài khoản | Account information not found |
| 1058 | Loại thiết bị hiện tại chưa hỗ trợ tính năng này | The current device type does not support this feature yet |
| 1059 | Ngân hàng hiện tại chưa hỗ trợ tính năng này | The current bank does not support this feature yet |
| 1060 | Shop NFC chưa được cấu hình | Shop NFC has not been configured |
| 1061 | Cấu hình tối thiểu 0 module trở lên | Configure at least 0 modules |
| 1062 | Thẻ NFC đã được sử dụng | NFC card is already in use |
| 1063 | Không hỗ trợ đối với ngân hàng này | Not supported for this bank |
| 1064 | Không hỗ trợ đối với loại deep link này | Not supported for this deep link type |
| 1065 | OTP đã hết thời gian chờ, vui lòng thử lại | OTP has timed out; please try again |
| 1066 | Không tìm thấy thông tin đăng ký lưu trữ | Stored registration information not found |
| 1067 | Không tìm thấy thông tin đăng ký | Registration information not found |
| 1068 | Không tìm thấy nền tảng hỗ trợ thanh toán này | This payment platform was not found |
| 1069 | Tài khoản chưa được cấu hình thông tin của OnePay | OnePay information has not been configured for the account |
| 1070 | Cửa hàng không tồn tại hoặc đã bị xóa. Vui lòng thử lại! | Shop does not exist or has been deleted. Please try again |
| 1071 | Cửa hàng liên kết với STK ảo không tồn tại hoặc đã bị xóa. Vui lòng thử lại! | The shop linked to the virtual account does not exist or has been deleted. Please try again |
| 1072 | Không tìm thấy STK ảo được liên kết với Merchant | No virtual account linked to the Merchant was found |
| 1073 | Mã QRCode không hợp lệ | Invalid QR code |
| 1074 | Mã QRCode đã được sử dụng | QR code has already been used |
| 1075 | Có lỗi trong quá trình cập nhật trạng thái liên kết thiết bị với cửa hàng. Vui lòng thử lại! | An error occurred while updating the device-to-shop link status. Please try again |
| 1076 | Thông tin hóa đơn không tồn tại | Invoice information does not exist |
| 1077 | Phiên đăng nhập đã hết hạn. | Login session has expired |
| 1078 | Mã bảo mật không chính xác. | Incorrect security code |
| 1079 | Giao dịch chi hộ có bản ghi không hợp lệ. | The disbursement transaction contains invalid records |
| 1080 | ConfirmId không chính xác. | Incorrect ConfirmId |
| 1081 | Số tài khoản này hiện đang được liên kết với Doanh nghiệp/Hộ Kinh doanh khác | This account number is currently linked to another business / household business |
| 1082 | Tên Doanh nghiệp không hợp lệ | Invalid business name |
| 1083 | Dữ liệu liên kết tài khoản không hợp lệ | Invalid account linking data |
| 1084 | Số tài khoản định danh chứa ký tự không hợp lệ | The identification account number contains invalid characters |
| 1085 | Không thể liên kết tài khoản vào Cửa hàng không hoạt động | Cannot link an account to an inactive shop |
| 1086 | Config BAOKIM chưa được thiết lập. | BAOKIM config has not been set up |
| 1087 | Cấu hình ID ví BAOKIM chưa được thiết lập. | BAOKIM wallet ID configuration has not been set up |
| 1088 | Ví BAOKIM chưa đồng bộ. | BAOKIM wallet has not been synced |
| 1089 | Thông tin Ví để đồng bộ với Tingee không tồn tại hoặc đã hết hạn. Vui lòng thử lại sau. | The wallet information to sync with Tingee does not exist or has expired. Please try again later |
| 1090 | Config VPB chưa được thiết lập. | VPB config has not been set up |
| 1091 | Số tài khoản ảo ACB chứa ký tự không hợp lệ. Xin vui lòng thử lại! | The ACB virtual account number contains invalid characters. Please try again |
| 1092 | Số tài khoản ảo chưa khai báo trên app MSB | The virtual account number has not been registered in the MSB app |
| 1093 | Vietcombank token không hợp lệ | Invalid Vietcombank token |
| 1094 | Thông tin cửa hàng này không thuộc Master Merchant | This shop does not belong to the Master Merchant |
| 1095 | Tài khoản Merchant không thuộc Master Merchant | The Merchant account does not belong to the Master Merchant |
| 1096 | Giá trị Merchant ID không được bỏ trống | Merchant ID must not be empty |
| 1097 | Phiên liên kết ngân hàng không hợp lệ | Invalid bank linking session |
| 1098 | Phiên liên kết ngân hàng đã hết hạn | Bank linking session has expired |
| 1099 | Chữ ký phiên liên kết không hợp lệ | Invalid linking session signature |
| 1100 | Không tìm thấy API credential này. | API credential not found |
| 1101 | Bạn không có quyền thao tác trên API credential này. | You do not have permission to operate on this API credential |
| 1102 | Có lỗi trong quá trình xử lý trên hệ thống ngân hàng/ví điện tử. | An error occurred while processing on the bank / e-wallet system |
| 1103 | Cửa hàng đã có thiết bị khóa theo ngân hàng 0, không thể liên kết thêm tài khoản ngân hàng 1. | The shop already has a device locked to bank 0; a bank account of bank 1 cannot be linked |
| 1104 | Cửa hàng đã có tài khoản liên kết ngân hàng 0, không thể thêm thiết bị khóa theo ngân hàng 1. | The shop already has a linked account of bank 0; a device locked to bank 1 cannot be added |
| 1105 | Không tìm thấy lịch sử giao dịch. | Transaction history not found |
| 1106 | Thời gian giao dịch không đúng định dạng (yyyyMMddHHmmss) | Transaction time is not in the correct format (yyyyMMddHHmmss) |
| 1107 | Khoảng thời gian không được quá 0 ngày | The time range must not exceed 0 days |
| 1108 | Số bản ghi của 1 trang quá lớn. | Page size is too large |
| 1109 | Không tìm thấy giao dịch Direct Link. | Direct Link transaction not found |
| 1110 | Chỉ có thể thao tác với giao dịch ở trạng thái DRAFT. Trạng thái hiện tại: 0. | Only transactions in DRAFT status can be modified. Current status: 0 |
| 1111 | Danh sách mã giao dịch không được trống. | Transaction code list must not be empty |
| 1112 | Danh sách giao dịch không được bỏ trống | Transaction list must not be empty |
| 1113 | Mã xác thực đã hết hạn. Vui lòng đăng nhập lại | Authentication code has expired. Please log in again |
| 1114 | Thông tin xác thực không hợp lệ | Invalid authentication information |
| 1115 | Không tìm thấy thông tin ngân hàng nhận | Receiving bank information not found |
| 1116 | Mã tham chiếu giao dịch đã tồn tại | Transaction reference code already exists |
| 1117 | Hệ thống Ví điện tử chưa hỗ trợ tính năng này. | The e-wallet system does not support this feature yet |
| 1118 | Không tìm thấy thông tin giao dịch. | Transaction information not found |
| 1119 | Token xác thực không hợp lệ. Vui lòng kiểm tra lại! | Invalid authentication token. Please check again |
| 1120 | Thiếu giá trị Token Ref | Missing Token Ref value |
| 1121 | Thiếu giá trị Return Url | Missing Return Url value |
| 1122 | Dữ liệu lưu trữ không tồn tại hoặc đã hết hạn. Vui lòng thử lại sau! | Stored data does not exist or has expired. Please try again later |
| 1123 | Thông tin xác thực không hợp lệ. Vui lòng thử lại sau! | Invalid authentication information. Please try again later |
| 1124 | RequestId đã tồn tại. | RequestId already exists |
| 1125 | Số tiền cần hoàn lại vượt quá số tiền đã thanh toán | The refund amount exceeds the paid amount |
| 1126 | Khoảng thời gian quá lớn. | Time range is too large |
| 1127 | Không thể xóa cửa hàng đã phát sinh giao dịch. | Cannot delete a shop that already has transactions |
| 1128 | Cửa hàng này đã sử dụng hết 5 lượt tắt nhận thông báo biến động số dư trong tháng này. Lượt tắt sẽ được đặt lại vào 00:00 ngày 01 của tháng tiếp theo. | This shop has used all 5 times it can turn off balance notifications this month. The count resets at 00:00 on the 1st of the next month |
| 1129 | Thiết bị chưa được gán với Master Merchant | Device has not been assigned to the Master Merchant |
| 1130 | Số điện thoại không khớp. | Phone number does not match |
| 1131 | Bạn đang thao tác quá nhanh. | You are sending requests too quickly |
| 1132 | Không tìm thấy hóa đơn | Invoice not found |
| 1133 | Không có quyền thực hiện hành động này. | No permission to perform this action |
| 1134 | Xác thực không thành công. | Authentication failed |
| 1135 | Không tìm thấy requestId. | requestId not found |
| 2001 | Token thanh toán không hợp lệ. | Invalid payment token |
| 2002 | Chữ ký thanh toán không hợp lệ. vui lòng kiểm tra dữ liệu gốc trước khi mã hóa | Invalid payment signature. Please check the original data before encoding |
| 2003 | Phiên thanh toán đã hết hạn. | Payment session has expired |
| 2004 | Không tìm thấy link thanh toán. | Payment link not found |
| 2005 | Mã hóa đơn đã được thanh toán. | The invoice code has already been paid |
| 2006 | Không thể hủy link thanh toán với trạng thái: 0. | Cannot cancel a payment link with status: 0 |
| 2007 | Nhà cung cấp 0 chưa được hỗ trợ | Provider 0 is not supported yet |
| 2008 | Vui lòng cấu hình cổng thanh toán để sử dụng dịch vụ | Configure the payment gateway to use the service |
| 2009 | Phương thức thanh toán không hợp lệ. | Invalid payment method |
| 2010 | Trạng thái thanh toán không hợp lệ. | Invalid payment status |
| 2011 | Mã yêu cầu (requestId) đã được sử dụng. Vui lòng tạo mã yêu cầu mới để tiếp tục. | The request ID (requestId) has already been used. Generate a new request ID to continue |
| 2012 | Phương thức thanh toán bằng thẻ chưa được kích hoạt cho Merchant này. | Card payment has not been activated for this Merchant |
| 2013 | Phương thức thanh toán Thẻ ATM nội địa không hỗ trợ | Domestic ATM card payment is not supported |
| 2014 | Phương thức thanh toán Thẻ quốc tế không hỗ trợ | International card payment is not supported |
| 2015 | Giao dịch bằng thẻ ATM có hạn mức tối đa là 2.000.000 VNĐ/giao dịch. | ATM card transactions are limited to 2,000,000 VND per transaction |
| 2016 | Tài khoản không đủ số dư để thực hiện giao dịch. | Insufficient account balance for the transaction |
| 2017 | Giao dịch vượt quá hạn mức cho phép trong ngày. | The transaction exceeds the daily limit |
| 2018 | Giao dịch thanh toán thẻ thất bại. Vui lòng thử lại hoặc chọn phương thức khác. | Card payment failed. Please try again or choose another method |
| 2019 | Mã xác thực đã hết hạn hoặc không hợp lệ | Verification code has expired or is invalid |
| 2020 | Mã xác thực không chính xác | Incorrect verification code |
| 2021 | Phương thức Trả góp không được hỗ trợ | Installment payment is not supported |
| 2022 | Giá trị hóa đơn tối thiểu để trả góp là 0 VNĐ | The minimum invoice amount for installments is 0 VND |
| 2023 | Tài khoản không nằm trong danh sách cấu hình của Payment Gateway | The account is not in the payment gateway configuration list |
| 2024 | Không thể khởi tạo liên kết thanh toán Payoo | Could not initialize the Payoo payment link |
| 2025 | Checksum không hợp lệ. | Invalid checksum |
| 2026 | Checksum deeplink không hợp lệ | Invalid deep link checksum |
| 2027 | Không tìm thấy cấu hình Webhook này. | Webhook configuration not found |
| 2028 | Bạn không có quyền thao tác trên cấu hình Webhook này. | You do not have permission to operate on this webhook configuration |
| 2029 | Lịch sử gửi webhook chỉ được lưu trữ trong vòng 90 ngày. | Webhook delivery history is kept for 90 days only |
| 2030 | Chưa cấu hình tài khoản nhà cung cấp 0 này | The account for provider 0 has not been configured |
| 2031 | Tài khoản 0 đã tồn tại cho merchant này | Account 0 already exists for this merchant |
| 2032 | Chưa cấu hình tài khoản nhà cung cấp mặc định | No default provider account has been configured |
| 2033 | Không thể xóa tài khoản mặc định. | Cannot delete the default account |
| 2034 | Hóa đơn 0 đã được xuất thành công trước đó. | Invoice 0 has already been issued successfully |
| 2035 | Hóa đơn 0 chưa được xuất thành công, không thể thực hiện hành động này. | Invoice 0 has not been issued successfully; this action cannot be performed |
| 2036 | Tài khoản chưa đăng ký dịch vụ Hoá đơn đầu vào của nhà cung cấp 0 | The account has not registered for the purchase invoice (input invoice) service of provider 0 |
| 2037 | Tài khoản chưa đăng ký dịch vụ Hoá đơn đầu ra của nhà cung cấp 0 | The account has not registered for the sales invoice (output invoice) service of provider 0 |
| 2038 | Nhà cung cấp 0 không hỗ trợ loại hàng hóa này | Provider 0 does not support this type of goods |
| 2039 | File không tồn tại. | File does not exist |
| 2040 | Khoảng thời gian không hợp lệ | Invalid time range |
Note
For error codes not listed above, contact TINGEE for details.