API kiểm tra lịch sử giao dịch ngân hàng

Hướng dẫn API kiểm tra lịch sử giao dịch ngân hàng của autobank.dev

Tích hợp API

Việc tích hợp với API được thực hiện qua giao thức HTTP, vì thế dễ dàng tích hợp vào bất cứ nền tảng, ngôn ngữ lập trình nào.

Việc giải kiểm tra lịch sử giao dịch ngân hnagf được thực hiện qua 2 bước:

Bước 1: Gửi token của ngân hàng cần kiểm tra sang autobank.dev qua HTTP POST.

Bước 2: Nhận kết quả API kiểm tra lịch sử giao dịch ngân hàng

1. Ngân hàng trong hệ thống

• BIDV

• ACB

• VCB

• MBBANK

• TPBANK

2. Tạo yêu cầu/Request

POST : https://autobank.dev/apiv2/autobank/history

Các tham số Body:

Tên trường dữ liệu	Kiểu dữ liệu	Bắt buộc	Mô tả
token	String	x	token của ngân hàng kết nối với hệ thống, được gửi qua Email của bạn
countlimit	int		Số lượng giao dịch tối đa cần kiểm tra, mặc định = 10

Lưu ý: Mỗi tài khoản ngân hàng sẽ có 1 token riêng, token được gửi về EMAIL của bạn khi kết nối với hệ thống

POST HTTP
Url: https://autobank.dev/apiv2/autobank/history
Content-Type: application/json

{
	"token": "YOUR_TOKEN",
	"countlimit": "YOUR_COUNT_LIMIT"
}

Kết quả trả về/Response

Kết quả trả về dạng JSON gồm các trường sau

Tên trường dữ liệu	Kiểu dữ liệu	Mô tả
status	int	Mã thông báo xác định kết quả 1 : Thành công 0 : Thất bại
mes	string	Thông báo tương ứng nếu có
data	object	Danh sách lịch sử giao dịch

Data: lịch sử giao dịch gồm các trường sau

Tên trường dữ liệu	Kiểu dữ liệu	Mô tả
transactionID	string	Mã giao dịch
amount	decimal	Số tiền giao dịch
description	string	Nội dung chuyển khoản
transactionDate	long	Thời gian giao dịch
type	string	Loại giao dịch "IN" : Nhận tiền "OUT" : Chuyển tiền

Mẫu kết quả trả về

Thành công

{
    "status": 1,
    "mes":"Thành công",
    "data":[
        {
            "transactionID":"4871",
            "amount":10000.0,
            "description":"P chuyen tien GD 645494-050225 11:18:23",
            "transactionDate":"1746378000000",
            "type":"IN"
        },
        {
            "transactionID":"4869",
            "amount":10000.0,
            "description":"7H761541P.CT tu 9 P toi P tai ACB GD 145232-050225 01:04:21",
            "transactionDate":"1746378000000",
            "type":"OUT"
        },
        {
            "transactionID":"4867",
            "amount":150000.0,
            "description":"G chuyen tien.CT tu 9 P toiG tai ACB GD 209964-050125 20:39:31",
            "transactionDate":"1746378000000","type":"IN"
        },
        {
            "transactionID":"4865",
            "amount":20000.0,
            "description":"PHAM HONG PHONG chuyen tien GD 717987-050125 18:42:50",
            "transactionDate":"1746378000000",
            "type":"OUT"
        }
    ]
}

Thất bại

{
    "status":0, // STATUS khác 1
    "mes":"token không chính xác"
}