API NCB – API ngân hàng NCB mới nhất

API NCB của SePay giúp bạn truy vấn thông tin giao dịch ngân hàng NCB (Ngân hàng TMCP Quốc Dân) qua API. Hỗ trợ danh sách giao dịch NCB, lấy thông tin chi tiết một giao dịch cụ thể như: Ngày giao dịch, số tiền, mã tham chiếu, số dư tài khoản, nội dung thanh toán.

Các bước thực hiện:

Bước 1: Đăng ký tài khoản SePay tại my.sepay.vn/register, sau đó thêm tài khoản ngân hàng NCB.

Bước 2: Vào my.sepay.vn -> API Access, tạo API Token. API Token cần được đưa vào header mỗi khi request đến SePay API. Với cấu trúc header:

• Authorization: Bearer API-TOKEN
• Content-Type: application/json

Bước 3: Bạn có thể sử dụng API NCB như sau:

Lưu ý: Nếu bạn muốn các bước kết nối ngân hàng được thực hiện ở phía phần mềm của bạn, mà người dùng không phải đăng ký tài khoản tại SePay, hãy tham khảo giải pháp SePay Bank Hub

API NCB để lấy danh sách giao dịch ngân hàng

GET https://my.sepay.vn/userapi/transactions/list

Bạn có thể lọc theo các tham số sau khi gửi API:

Ví dụ API NCB:

API lấy tất cả giao dịch gần nhất

Mặc định chỉ hiển thị 5000 giao dịch gần nhất.

• GET https://my.sepay.vn/userapi/transactions/list

HTTP/1.1 200 OK
----
{
    "status": 200,
    "error": null,
    "messages": {
        "success": true
    },
    "transactions": [
        {
            "id": "49682",
            "bank_brand_name": "NCB",
            "account_number": "190004678888",
            "transaction_date": "2024-05-05 19:59:48",
            "amount_out": "0.00",
            "amount_in": "18067000.00",
            "accumulated": "1200541768.00",
            "transaction_content": "NGUYEN TIEN LUAT chuyen tien...",
            "reference_number": null,
            "code": null,
            "sub_account": null,
            "bank_account_id": "21"
        },
        {
            "id": "49582",
            "bank_brand_name": "NCB",
            "account_number": "190004679999",
            "transaction_date": "2024-05-05 17:59:47",
            "amount_out": "0.00",
            "amount_in": "13646000.00",
            "accumulated": "1384635819.00",
            "transaction_content": "DINH NHU TOAN chuyen tien...",
            "reference_number": null,
            "code": null,
            "sub_account": null,
            "bank_account_id": "20"
        },
        {
            "id": "49465",
            "bank_brand_name": "NCB",
            "account_number": "190004678888",
            "transaction_date": "2024-05-05 15:59:47",
            "amount_out": "0.00",
            "amount_in": "21782000.00",
            "accumulated": "1182474768.00",
            "transaction_content": "NGUYEN TIEN LUAT chuyen tien...",
            "reference_number": null,
            "code": null,
            "sub_account": null,
            "bank_account_id": "21"
        }
    ]
}

API lấy giao dịch sau 08h00 ngày 30/04/2023 và trước 12h00 ngày 02/05/2023.

• GET https://my.sepay.vn/userapi/transactions/list?transaction_date_min=2024-04-30 08:00:00&transaction_date_max=2024-05-02 12:00:00

API  lấy giao dịch từ ID 49050 trở về sau.

• GET https://my.sepay.vn/userapi/transactions/list?since_id=49050

API  lấy 20 giao dịch gần đây của tài khoản ngân hàng số 190004678888.

• GET https://my.sepay.vn/userapi/transactions/list?account_number=190004678888&limit=20

API  lọc giao dịch có mã tham chiếu là 171158.050523.060001

• GET https://my.sepay.vn/userapi/transactions/list?reference_number=171158.050523.060001

API  lấy các giao dịch với số tiền chuyển vào là 16,848,000

• GET https://my.sepay.vn/userapi/transactions/list?amount_in=16848000

API NCB đếm số lượng giao dịch 

GET https://my.sepay.vn/userapi/transactions/count

Đếm số lượng giao dịch. Bạn có thể lọc theo các tham số sau:

Ví dụ đếm tổng số lượng giao dịch.

• GET https://my.sepay.vn/userapi/transactions/count

HTTP/1.1 200 OK
----
{
    "status": 200,
    "error": null,
    "messages": {
        "success": true
    },
    "count_transactions": 2322
}

Ví dụ đếm tổng số lượng giao dịch của tài khoản ngân hàng 190004678888.

• GET https://my.sepay.vn/userapi/transactions/count?account_number=190004678888

API NCB lấy chi tiết một giao dịch 

GET https://my.sepay.vn/userapi/transactions/details/{transaction_id}

Lấy chi tiết thông tin một giao dịch theo ID

Ví dụ:

• GET https://my.sepay.vn/userapi/transactions/details/48673

HTTP/1.1 200 OK
----
{
    "status": 200,
    "error": null,
    "messages": {
        "success": true
    },
    "transaction": {
        "id": "48673",
        "transaction_date": "2024-05-04 11:59:47",
        "account_number": "190004678888",
        "sub_account": null,
        "amount_in": "19689000.00",
        "amount_out": "0.00",
        "accumulated": "1128200335.00",
        "code": null,
        "transaction_content": "TRAN THIEN THAO chuyen tien...",
        "reference_number": null,
        "bank_brand_name": "NCB",
        "bank_account_id": "21"
    }
}

Xem thêm API cho các ngân hàng khác tại đây.