2.2. Xác thực OTP

Entrade cung cấp 2 phương thức để xác thực OTP cho giao dịch qua API, có thể sử dụng một trong 2 phương thức này để xác thực:

• Xác thực bằng SMS OTP

• Xác thực bằng Email OTP

Xác thực bằng SMS OTP

Bước 1: Lấy SMS OTP thông qua API

• Khi dùng API SMS OTP thì mã OTP sẽ được gửi tới số điện thoại đăng ký khi tạo tại khoản trên Entrade X (DNSE).

• Mã OTP sẽ có hiệu lực trong vòng 2 phút và chỉ dùng được 1 lần, khi dùng xong hoặc hết hiệu lực thì cần dùng API này để lấy mã mới

URL	Method
https://services.entrade.com.vn/entrade-api/otp	GET

Resquest header

Field	Type	Description
Authorization		Bearer <JWT token>

Resquest body

Field	Type	Description
N/A

Response body

Field	Type	Description
N/A

Bước 2: Xác thực OTP

• Sau khi xác thực OTP thành công, hệ thống sẽ cấp trading-token

• Trading token sẽ được sử dụng trong các API chỉnh sửa dữ liệu: đặt lệnh, huỷ lệnh

• Trading token sẽ có hiệu lực trong vòng 8h, khi hết hiệu lực cần dùng API này để xác thực và lấy lại trading-token mới.

URL	Method
https://services.entrade.com.vn/entrade-api/otp/trading-token	POST

Resquest header

Field	Type	Description
Authorization		Bearer <JWT token>
otp	String	Mã sms otp lấy từ tin nhắn nhận trong bước 1

Resquest body

Field	Type	Description
N/A

Response body

Field	Type	Description
tradingToken	String	Trading token (có hiệu lực trong 8 tiếng)

Xác thực bằng Email OTP

Bước 1: Đăng ký

Đăng ký sử dụng Email OTP bằng cách liên hệ với phòng Dịch vụ Khách hàng

Bước 2: Lấy OTP bằng email

Sau khi đăng ký thành công với Dịch vụ khách hàng, KH có thể sử dụng API lấy OTP bằng email.

• Khi dùng API Email OTP thì mã OTP sẽ được gửi tới địa chỉ email đăng ký khi tạo tại khoản trên Entrade X. Hướng dẫn xem email hiện tại (Lưu ý: Email cần được xác thực trước khi dùng API)

• Mã OTP sẽ có hiệu lực trong vòng 2 phút và chỉ dùng được 1 lần, khi dùng xong hoặc hết hiệu lực thì cần dùng API này để lấy mã mới

URL	Method
https://services.entrade.com.vn/entrade-api/email-otp	GET

Resquest header

Field	Type	Description
Authorization		Bearer <JWT token>

Resquest body

Field	Type	Description
N/A

Response body

Field	Type	Description
N/A

Bước 3: Xác thực OTP

• Sau khi xác thực OTP thành công, hệ thống sẽ cấp trading-token

• Trading token sẽ được sử dụng trong các API chỉnh sửa dữ liệu: đặt lệnh, huỷ lệnh

• Trading token sẽ có hiệu lực trong vòng 8h, khi hết hiệu lực cần dùng API này để xác thực và lấy lại trading-token mới.

URL	Method
https://services.entrade.com.vn/entrade-api/otp/trading-token	POST

Resquest header

Field	Type	Description
Authorization		Bearer <JWT token>
otp	String	Mã otp lấy từ API Email OTP (Bước 2)

Resquest body

Field	Type	Description
N/A

Response body

Field	Type	Description
tradingToken	String	Trading token (có hiệu lực trong 8 tiếng)