Xác minh tài khoản ngân hàng qua VA

POST

/partner/vnvn/va-verify

Tra cứu và xác minh thông tin chủ tài khoản ngân hàng (số tài khoản hoặc số thẻ) thông qua hệ thống VA. Partner phải đã được cấu hình tài khoản VA.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Xác minh tài khoản thành công

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠429

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.itax.dev/partner/vnvn/va-verify' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "bankId": "BIDV",
    "bankRefNumber": "1234567890"
}'

Response Example

200 - Xác minh thành công

{
    "statusCode": 200,
    "message": "Bank account verified successfully",
    "data": {
        "success": true,
        "message": "Xác thực thành công",
        "data": {
            "accountType": "ACCOUNT",
            "bankRefNumber": "1234567890",
            "bankRefName": "NGUYEN VAN A",
            "bankId": "BIDV"
        },
        "code": null
    }
}

Modified at 2026-05-13 14:44:08

Lấy danh sách ngân hàng liên kết hệ thống

Thanh toán / Giải ngân đến tài khoản ngân hàng