Các lỗi thường gặp

1. Lỗi -2: APPID_INVALID, khi tạo đơn hàng

• Truyền thiếu hoặc viết sai chính tả param appid. Đúng: appid. Sai: appId, Appid, ...

• Truyền sai Content-Type:

  • Content-Type: application/x-www-form-urlencoded. Không hỗ trợ các Content-Type khác như: application/json, application/xml, ...

2. Lỗi -53: HMAC_INVALID, khi tạo đơn hàng

• Truyền thiếu hoặc sai chính tả các param bắt buộc, xem lại tại đây

• Sai Mac Key (Key1), hoặc sai định dạng dữ liệu để tạo ra param mac, xem lại tại đây

3. Lỗi -54: TIME_INVALID, khi thanh toán

Thời gian thanh toán không hợp lệ (dù có thể vừa mới được tạo ra)

• param apptime lấy chưa đúng theo unix timestamp in milisecond

• Thời điểm tạo đơn hàng lệch quá 15 phút so với thời điểm thanh toán

• Đồng hồ máy tính của Merchant bị sai giờ

4. Lỗi -68: DUPLICATE_APPTRANSID, khi thanh toán

• Đơn hàng này đã được thanh toán, hoặc trùng apptransid với một đơn hàng đã thanh toán trước đó. apptransid phải là duy nhất

5. Lỗi -92: APPTRANSID_INVALID, khi thanh toán

• Param apptransid chưa đúng định dạng, đúng định dạng phải bắt đầu theo format yyMMdd của ngày hiện tại
• yyMMdd chưa đúng TimeZone Vietnam (GMT+7) (Vì các giao dịch đối soát theo ngày giờ Việt Nam)

6. Lỗi -49: TRANS_INFO_NOT_FOUND, khi truy vấn trạng thái đơn hàng

Giao dịch chưa được thực hiện hoặc có thể đã thực hiện thành công nhưng có thể xảy ra các trường hợp sau:

• Do gọi API truy vấn trong hàm handle callback, khi này giao dịch vẫn ở trạng thái đang xử lý (isprocessing=true). Gọi sau khi response callback thì mới lấy được trạng thái FINAL của giao dịch. Tuy nhiên khi nhận callback là giao dịch đã thành công, không cần gọi API truy vấn trạng thái nữa.

• Gọi API sau 48h kể từ lúc ZaloPay khi nhận đơn hàng. Giao dịch chỉ có hiệu lực trong vòng 48h. Nếu sau 48h cần kiểm tra trạng thái của một giao dịch thì sử dụng Merchant Tool https://mc.zalopay.vn/home

Hotline: 1900 54 54 36

| Email: hotro@zalopay.vn