search

3️⃣API Get Token

Used to generate and retrieve a token. Used to obtain a bearer token for accessing the API to generate VietQR payment codes.

hashtag
POST

https://dev.vietqr.org/vqr/api/token_generate

Headers

Name
Value

Content-Type

application/json

Authorization

Basic Authentication: Base64[username:password]

Body

Name
Type
Description

access_token

String

It is the Bearer Token provided by VietQR after completing Step 4.

Used to access and generate VietQR payment codes.

token_type

String

It is a “Bearer” type token.

expires_in

String

The token expiration time is set to 300 seconds by default.

Response

{
    "access_token": "bearer_token_của_đối_tác",
    "token_type": "Bearer",
    "expires_in": 300
}

Reference code

curl --location --request POST 'https://dev.vietqr.org/vqr/api/token_generate' \
--header 'Authorization: Basic Y3VzdG9tZXItdmlldHFydGVzdC11c2VyMjQ2ODpZM1Z6ZEc5dFpYSXRkbWxsZEhGeWRHVnpkQzExYzJWeU1qUTJPQT09'
Response:
{
    "access_token": "eyJhbGciOiJIUzUxMiJ9.eyJhdXRob3JpdGllcyI6WyJST0xFX1VTRVIiXSwidXNlciI6IlkzVnpkRzl0WlhJdGRtbGxkSEZ5ZEdWemRDMTFjMlZ5TWpRMk9BPT0iLCJpYXQiOjE3MjEzNzI2MzQsImV4cCI6MTcyMTM3MjkzNH0.D19qvrpYHUgcGjDCXuXXAv3j6lZr6tfmIB0VzdCzAXMJAElGok04sNLysS6PRLdRb0hSgEX5_9KpLjB-xErn-A",
    "token_type": "Bearer",
    "expires_in": 300
}

hashtag
Frequently Asked Questions (FAQs)

chevron-rightWhat is the Get Token API used for?hashtag

API Get Token được sử dụng để cấp quyền truy cập vào các dịch vụ của VietQR bằng cách cung cấp một mã token (access_token). Mã token này sẽ được sử dụng trong các yêu cầu API khác để xác thực người dùng.

chevron-rightHow do I call the Get Token API?hashtag

Bạn cần gửi một yêu cầu POST đến endpoint của API Get Token với thông tin xác thực (username và password) trong phần header. VietQR sẽ cung cấp thông tin này cho bạn sau khi hoàn tất quá trình đăng ký.

chevron-rightHow long is the token valid for?hashtag

Token được cấp bởi API Get Token thường có thời gian sử dụng là 300 giây (5 phút). Sau thời gian này, bạn cần gọi lại API để lấy token mới.

chevron-rightWhat should I do if I receive an error message when calling the Get Token API?hashtag

Kiểm tra lại các thông tin bạn đã gửi, bao gồm username và password. Đảm bảo rằng các thông tin này đúng và vẫn còn hiệu lực. Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ của VietQR để được giúp đỡ.

chevron-rightWhy am I receiving an error code when calling the Get Token API?hashtag

Các mã lỗi thường xuất hiện do vấn đề xác thực (sai username hoặc password), yêu cầu không hợp lệ, hoặc lỗi kết nối. Thông báo lỗi sẽ cung cấp chi tiết về nguyên nhân cụ thể, giúp bạn xác định và khắc phục vấn đề.

chevron-rightWhich environments can I use the token in?hashtag

Token được cấp có thể sử dụng trên các API của VietQR, tùy thuộc vào môi trường mà bạn đang sử dụng (Test hoặc Prod). Đảm bảo rằng bạn đang gọi API trên đúng môi trường tương ứng.

chevron-rightHow can I secure the token after receiving it?hashtag

Token cần được bảo mật như một thông tin nhạy cảm. Không chia sẻ token với bất kỳ ai và lưu trữ nó một cách an toàn. Khi sử dụng token, hãy đảm bảo rằng kết nối của bạn được mã hóa (sử dụng HTTPS) để bảo vệ thông tin khỏi bị lộ.

PreviousAPI Transaction SyncNextGọi API Generate VietQR Code

Last updated