API Kiểm tra thông tin tài khoản

Endpoint: /api/v1/service/transfer/bank/account/info

Method: POST

Header: Cách tạo JWT_TOKEN

Language: en | vi

{
    "X-APPOTAPAY-AUTH": Bearer JWT_TOKEN,
    "Content-Type": "application/json",
    "Language": LANGUAGE
}

Tham số

Tham số	Yêu cầu	Kiểu dữ liệu	Mô tả
bankCode	√	String	Mã ngân hàng theo quy định của AppotaPay được định nghĩa ở mục: Danh sách Ngân hàng hỗ trợ chuyển tiền.
accountNo	√	String	Số tài khoản hoặc số thẻ ngân hàng của khách hàng. Độ dài từ 4-22 ký tự
accountType	√	String	Phân loại accountNo account: Số tài khoản ngân hàng card: Số thẻ ngân hàng
partnerRefId	√	String	Là mã duy nhất tương ứng với một request gửi lên
signature	√	String	Chữ ký các tham số truyền lên API, các tham số được đưa vào chữ ký theo thứ tự bao gồm: accountNo + accountType + bankCode + partnerRefId (xem thêm phần cách tạo signature)

Dữ liệu trả về

Tham số	Kiểu dữ liệu	Mô tả
errorCode	Integer	Mã lỗi trả về
message	String	Mô tả chi tiết mã lỗi
accountInfo	Object	Thông tin tài khoản bank
accountInfo.accountNo	String	Số tài khoản hoặc số thẻ ngân hàng của khách hàng
accountInfo.accountName	String	Tên chủ tk/thẻ KH.
accountInfo.bankCode	String	Mã ngân hàng
accountInfo.accountType	String	Phân loại accountNo: account: Số tài khoản ngân hàng card: Số thẻ ngân hàng
signature	String	Chữ ký các tham số trả về, các tham số được đưa vào chữ ký theo thứ tự bao gồm: accountName + accountNo + errorCode (xem thêm phần cách tạo signature)

Ví dụ

Request

{
    "bankCode": "TPBANK",
    "accountNo": "13210013240000",
    "accountType": "account",
    "partnerRefId":"P199212928",
    "signature": "b5bb9a6e9c71281fb1e06d"
}

Response

{
    "errorCode": 0,
    "message": "Thành công",
    "accountInfo": {
        "accountNo":13210013240000,
        "accountName":"NGUYEN VAN A",
        "bankCode":"TPBANK",
        "accountType":"account"
    },
    "signature": "b5bb9a6e9c71281fb1e06d"
}