💳 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 60 request/phút. Nếu vượt quá giới hạn này, sẽ trả về lỗi:

429 Too Many Requests

📌 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