Lấy giao dịch

Đọc trạng thái hiện tại của một giao dịch theo user_id và ref_id.

Endpoint

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

{
  "user_id": "user_00000001",
  "ref_id": "ref_00000001"
}

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.

Trả về: GetTransactionResponse

Ví dụ request

curl --location '<BASE_URL>/v1/get_transaction' \
  --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"
  }'

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	NOT_VERIFIED, VERIFIED hoặc EXPIRED.
errors	array	Chi tiết từng lỗi. Rỗng khi thành công.

Lỗi

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

• Xác minh khóa xác thực giao dịch — chuyển một giao dịch sang VERIFIED
• Tạo giao dịch — nơi giao dịch được mở