API Thông tin Link Token

API lấy thông tin chi tiết của link token bao gồm trạng thái, sessions, events và các metadata liên quan.

API Endpoint

POST

https://bankhub-api-sandbox.sepay.vn/v1/link-token/get

Path Parameters

link_tokenstringrequired

Token string của link token (UUID format)

Headers

link_tokenstringrequired

Token string của link token (UUID format)

Lưu ý

API này yêu cầu Bearer Token trong header Authorization
Trả về thông tin chi tiết bao gồm company, sessions và events
Sessions chứa lịch sử các lần người dùng truy cập link token
Events chứa các sự kiện lifecycle của link token

Xử lý lỗi

404Not Found

Link token không tồn tại hoặc không thuộc merchant này

401Unauthorized

Access token không hợp lệ hoặc đã hết hạn

400Validation Error

link_token không hợp lệ (format sai hoặc thiếu)

API Response

Response 200 - Thành công

{
  "xid": "string",
  "purpose": "LINK_BANK_ACCOUNT",
  "status": "Active",
  "completion_redirect_uri": "string",
  "is_mobile_app": 0,
  "language": "string",
  "session_count": 0,
  "created_at": "string",
  "updated_at": "string",
  "expires_at": "string",
  "company": {
    "full_name": "string",
    "status": "string",
    "xid": "string"
  },
  "sessions": [
    {
      "xid": "string",
      "context": null,
      "state": "PENDING",
      "status": "string",
      "result": null,
      "finished_at": "string",
      "expires_at": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "events": [
    {
      "xid": "string",
      "name": "string",
      "metadata": null,
      "created_at": "string"
    }
  ]
}

xidstring

ID duy nhất của link token

purposeenum

Mục đích của link token

statusenum

Trạng thái hiện tại

completion_redirect_uristring

URL chuyển hướng sau khi hoàn thành

is_mobile_appinteger

Có phải từ mobile app không

languagestring

Ngôn ngữ giao diện

session_countinteger

Số lần người dùng đã truy cập link token này

created_atstring

Thời điểm tạo

updated_atstring

Thời điểm cập nhật cuối

expires_atstring

Thời điểm hết hạn

companyobject

Thông tin công ty

sessionsarray<object>

Danh sách sessions

eventsarray<object>

Danh sách events

Code mẫu

curl --request POST \
  --url https://bankhub-api-sandbox.sepay.vn/v1/link-token/get \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"link_token":"3034ccc8-9cad-4b39-adb3-738c554a7b77"}'