API Thu hồi Link Token

API thu hồi link token đã được tạo trước đó. Link token sau khi bị thu hồi sẽ không thể sử dụng để truy cập WebView nữa.

API Endpoint

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

Path Parameters

link_token_xidstringrequired

ID của link token cần thu hồi (xid format)

Headers

link_token_xidstringrequired

ID của link token cần thu hồi (xid format)

Lưu ý
  • API này yêu cầu Bearer Token trong header Authorization
  • Link token sau khi bị thu hồi sẽ không thể sử dụng được nữa
  • Người dùng đang truy cập link token đó sẽ bị ngắt kết nối

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_xid không hợp lệ (format sai hoặc thiếu)

API Response

Response 200 - Thu hồi thành công
{
  "message": "Liên kết đã được thu hồi thành công"
}
messagestring
Response 404 - Không tìm thấy link token
{
  "code": 0,
  "message": "string",
  "status": 0,
  "error": "string"
}

Code mẫu

1
2
3
4
5
curl --request POST \
  --url https://bankhub-api-sandbox.sepay.vn/v1/link-token/revoke \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"link_token_xid":"80655c97-e9d8-4e76-adb7-652c3fbef58c"}'
Lưu ý quan trọng
  • Thu hồi là hành động không thể hoàn tác. Link token sau khi bị revoke không thể khôi phục
  • Người dùng đang sử dụng link token sẽ bị ngắt kết nối ngay lập tức
  • Nếu link token đã bị thu hồi trước đó, API vẫn trả về 404
  • Nên thu hồi link token ngay khi phát hiện bất thường hoặc người dùng hủy bỏ
Trước
—
Tiếp theo
—