Đối tượng: ErrorResponse

Nội dung phản hồi

Nội dung HTTP cho tất cả phản hồi HTTP không phải 200.

Phản hồi mẫu sẽ có dạng như sau:


  {
    "responseHeader": {
      "requestTimestamp": "1481899949611"
    },
    "errorResponseCode": "INVALID_IDENTIFIER",
    "errorDescription": "Unknown paymentIntegratorAccountId: PIAID1",
  }
Biểu diễn dưới dạng JSON
{
  "responseHeader": {
    object(ResponseHeader)
  },
  "errorResponseCode": string,
  "errorDescription": string,
}
Các trường
responseHeader

object(ResponseHeader)

REQUIRED: Tiêu đề chung cho tất cả các câu trả lời.

errorResponseCode

string

KHÔNG BẮT BUỘC: Cung cấp một trong các mã được liệt kê trong bảng dưới đây.

Mã phản hồi lỗi và mã HTTP được khuyên dùng
INVALID_API_VERSION 400

Được dùng nếu trình tích hợp không hỗ trợ phiên bản API của yêu cầu.

INVALID_PAYLOAD_SIGNATURE 401

Được dùng nếu chữ ký của tải trọng được gửi tới một khoá không xác định hoặc không hoạt động.

INVALID_PAYLOAD_ENCRYPTION 400

Được dùng nếu hoạt động mã hoá tải trọng bằng một khoá không xác định hoặc không hoạt động.

REQUEST_TIMESTAMP_OUT_OF_RANGE 400

Được dùng nếu request_timestamp không phải là ± 60 giây kể từ thời điểm hiện tại.

INVALID_IDENTIFIER 404

Được dùng nếu giá trị nhận dạng được gửi trong yêu cầu không hợp lệ hoặc không xác định. Trong đó có thể bao gồm paymentIntegratorAccountId, googlePaymentToken, captureRequestId, v.v. Bạn cần chỉ định loại giá trị nhận dạng không hợp lệ trong errorDescription.

IDEMPOTENCY_VIOLATION 412

Được dùng nếu yêu cầu vi phạm các yêu cầu về tính xác thực của yêu cầu.

INVALID_FIELD_VALUE 400

Được dùng nếu yêu cầu chứa một giá trị cho một trường không thuộc tập hợp các giá trị được hỗ trợ.

MISSING_REQUIRED_FIELD 400

Được dùng nếu một trường bắt buộc chưa được đặt trong yêu cầu.

PRECONDITION_VIOLATION 400

Được dùng nếu vi phạm một quy tắc ràng buộc về hoạt động (ví dụ: khi yêu cầu hoàn tiền vượt quá số tiền còn lại trong giao dịch).

USER_ACTION_IN_PROGRESS 400

Được dùng nếu yêu cầu không thể được xử lý tại thời điểm này vì yêu cầu sẽ làm gián đoạn một hành động đang thực hiện của người dùng và có tác dụng như một khoá hệ thống. Không được dùng mã này để chỉ ra lỗi do các lỗi đồng thời nội bộ cụ thể liên quan đến quá trình triển khai.

INVALID_DECRYPTED_REQUEST 400

Được dùng nếu có thể giải mã tải trọng yêu cầu nhưng không thể phân tích cú pháp thông báo kết quả.

errorDescription

string

KHÔNG BẮT BUỘC: Cung cấp nội dung mô tả về trạng thái này cho những người đại diện hỗ trợ gỡ lỗi. Xin lưu ý rằng người dùng sẽ không nhìn thấy thông tin này. Tệp này có thể chứa văn bản mô tả, không nhạy cảm dùng để gỡ lỗi. Lưu ý rằng một số giá trị của errorResponseCode phải đi kèm với thông tin chi tiết bổ sung trong trường này (ví dụ: INVALID_IDENTIFIER phải đi kèm với thông tin trong trường này về loại giá trị nhận dạng không hợp lệ).