Xác minh khóa xác thực giao dịch

Redeem authentication key được tạo ra bởi bước xác minh của một sản phẩm và chuyển giao dịch sang VERIFIED. Đây là bước biến một lần khớp khuôn mặt hoặc một lần đọc chip thành một giao dịch mà backend của bạn có thể tin tưởng.

Endpoint

POST /v1/verify_transaction_key
Content-Type: application/json

{
  "user_id": "user_00000001",
  "ref_id": "ref_00000001",
  "authentication_key": "<AUTHENTICATION_KEY>"
}

Tham số:

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
user_id	string	Có	—	ID của user.
ref_id	string	Có	—	ID tham chiếu giao dịch.
authentication_key	string	Có	—	Authentication key được tạo ra bởi bước xác minh diễn ra ngay trước lệnh gọi này. Đối với NFC, đây là verification_key từ Đọc NFC.

Trả về: VerifyTransactionKeyResponse

Ví dụ request

curl --location '<BASE_URL>/v1/verify_transaction_key' \
  --header 'Authorization: ATV <ACCESS_ID>:<SIGNATURE>' \
  --header 'X-TV-Timestamp: <TIMESTAMP>' \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "user_00000001",
    "ref_id": "ref_00000001",
    "authentication_key": "<AUTHENTICATION_KEY>"
  }'

Response

{
  "data": {
    "id": "69306e8a-68e3-43f6-97ae-02b8e7c356f7",
    "ref_id": "ref_00000001",
    "user_id": "user_00000001",
    "status": "VERIFIED"
  },
  "errors": []
}

Trường	Kiểu	Mô tả
data.id	string	ID duy nhất của giao dịch.
data.ref_id	string	ID tham chiếu giao dịch.
data.user_id	string	ID của user.
data.status	string	VERIFIED khi thành công.
errors	array	Chi tiết từng lỗi. Rỗng khi thành công.

WARNING

Hãy redeem key từ backend của bạn, không bao giờ từ ứng dụng. Authentication key là bằng chứng duy nhất cho việc người dùng đã vượt qua kiểm tra sinh trắc học — chỉ gọi endpoint này từ server đến server.

Lỗi

Mã	Thông báo
2001010	Không tìm thấy Access ID.
2001020	Lock giao dịch thất bại.
2001021	Request giao dịch không hợp lệ.
2001023	Khóa giao dịch không hợp lệ.
401100	Bạn không được phép thực hiện hành động này.
4001000	Tham số đầu vào vi phạm một ràng buộc.
4001001	Header X-TV-Timestamp đã hết hạn, cần một header mới.
5001000	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Mã	Mô tả
access_id_not_found	API key không đúng.
transaction_invalid_request	Request giao dịch không hợp lệ.
internal_server_error	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Mã	Mã lỗi	Mô tả
401	access_denied_exception	Bạn không được phép thực hiện hành động này.
500	internal_server_error	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Bước tiếp theo

• Lấy giao dịch — xác nhận trạng thái sau đó
• Xác minh NFC — bước xác minh dành riêng cho NFC