💳 API kiểm tra tên tài khoản

API kiểm tra tên tài khoản để lấy tên chủ tài khoản thông qua số tài khoản và mã ngân hàng.

🚦 Giới hạn truy cập

API Rate Limits

Hệ thống Pay2S giới hạn tối đa 10 request/phút cho mỗi tài khoản chính. Hạn mức được dùng chung giữa khóa tích hợp của tài khoản chính và tất cả khóa cửa hàng thuộc tài khoản đó. Việc đổi IP, đổi khóa cửa hàng hoặc chạy đồng thời nhiều request không làm tăng hạn mức. Nếu vượt quá giới hạn này, sẽ trả về lỗi:

429 Too Many Requests

Response kèm các header X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset; khi bị giới hạn có thêm Retry-After.

📌 API: Kiểm tra tên tài khoản

Method

Method: POST

🔗 Endpoint

https://api.pay2s.vn/userapi/get-recipient-name

🔐 Header

{
  "Content-Type": "application/json",
  "pay2s-token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."
}

• pay2s-token: Là chuỗi token base64 từ SecretKey, tạo khi đăng ký tài khoản thành công. Bạn có thể xem tại: Xem tại Tích hợp Web/App.

📥 Request Parameters

Key	Type	Required	Description
accountNumber	String	✓	Số tài khoản muốn kiểm tra.
bankCode	String	✓	Mã ngân hàng

🧪 Sample Request

{
  "accountNumber": "99979986",
  "bankCode": "970416"
}

📤 Sample Response

{
    "status": true,
    "messages": "Thành công",
    "data": {
        "account_number": "99979986",
        "account_holder_name": "CTY CP FUTE",
        "bank_code": "970416"
    }
}

Key	Description
account_number	Số tài khoản cần truy vấn
account_holder_name	Tên chủ tài khoản
bank_code	Mã bankcode ngân hàng