API Giao dịch

Giao dịch là các giao dịch ngân hàng đã phát sinh. Bạn có thể truy vấn thông tin chi tiết một giao dịch, danh sách giao dịch, đếm số lượng giao dịch.

Bạn có thể làm gì với Giao dịch?

SePay cho phép bạn thực hiện những truy vấn sau với Giao dịch:
GET
https://my.sepay.vn/userapi/transactions/list
- Lấy danh sách giao dịch
GET
https://my.sepay.vn/userapi/transactions/details/{transaction_id}
- Lấy chi tiết một giao dịch
GET
https://my.sepay.vn/userapi/transactions/count
- Đếm số lượng giao dịch

Lấy danh sách giao dịch

GET

/userapi/transactions/list

Content-Type: application/json
Authorization: Bearer {YOUR_API_TOKEN}

Lấy tất cả giao dịch. Mặc định chỉ hiển thị 5000 giao dịch gần nhất.
Tham số truy vấn

Tên	Loại	Bắt buộc	Mô tả
`account_number`	string	Không bắt buộc	Số tài khoản ngân hàng
`transaction_date_min`	string	Không bắt buộc	Hiển thị các giao dịch được tạo sau thời gian (>=). Định dạng yyyy-mm-dd
`transaction_date_max`	string	Không bắt buộc	Hiển thị các giao dịch được tạo trước thời gian (<=). Định dạng yyyy-mm-dd
`since_id`	integer	Không bắt buộc	Hiển thị giao dịch từ ID chỉ định (>=)
`limit`	integer	Không bắt buộc	Giới hạn số giao dịch trả về. Tối đa 5000, mặc định là 5000
`reference_number`	string	Không bắt buộc	Lấy giao dịch theo mã tham chiếu
`amount_in`	number	Không bắt buộc	Lấy giao dịch tiền vào khớp với số tiền chỉ định
`amount_out`	number	Không bắt buộc	Lấy giao dịch tiền ra khớp với số tiền chỉ định

bash

RESPONSE

{
  "status": 200,
  "error": null,
  "messages": {
    "success": true
  },
  "transactions": [
    {
      "id": "49682",
      "bank_brand_name": "Vietcombank",
      "account_number": "0071000888888",
      "transaction_date": "2023-05-05 19:59:48",
      "amount_out": "0.00",
      "amount_in": "18067000.00",
      "accumulated": "1200541768.00",
      "transaction_content": "DUONG THUY ANH chuyen tien...",
      "reference_number": "677760.050523.080001",
      "code": null,
      "sub_account": "VCB0011ABC004",
      "bank_account_id": "19"
    },
    {
      "id": "49582",
      "bank_brand_name": "Vietcombank",
      "account_number": "0071000899999",
      "transaction_date": "2023-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": "171158.050523.060001",
      "code": null,
      "sub_account": "VCB0011ABC002",
      "bank_account_id": "18"
    },
    {
      "id": "49465",
      "bank_brand_name": "Vietcombank",
      "account_number": "0071000888888",
      "transaction_date": "2023-05-05 15:59:47",
      "amount_out": "0.00",
      "amount_in": "21782000.00",
      "accumulated": "1182474768.00",
      "transaction_content": "DUONG THUY ANH chuyen tien...",
      "reference_number": "989543.050523.040001",
      "code": null,
      "sub_account": "VCB0011ABC001",
      "bank_account_id": "19"
    }
  ]
}

Ví dụ sử dụng

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

cURL

curl -X GET "https://my.sepay.vn/userapi/transactions/list?transaction_date_min=2023-04-30%2008:00:00&transaction_date_max=2023-05-02%2012:00:00" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Lấy giao dịch từ ID 49050 trở về sau

cURL

curl -X GET "https://my.sepay.vn/userapi/transactions/list?since_id=49050" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

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

cURL

curl -X GET "https://my.sepay.vn/userapi/transactions/list?account_number=0071000888888&limit=20" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

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

cURL

curl -X GET "https://my.sepay.vn/userapi/transactions/list?reference_number=171158.050523.060001" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

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

cURL

curl -X GET "https://my.sepay.vn/userapi/transactions/list?amount_in=16848000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Lấy chi tiết một giao dịch

GET

/userapi/transactions/details/{transaction_id}

Content-Type: application/json
Authorization: Bearer {YOUR_API_TOKEN}

Lấy chi tiết thông tin một giao dịch theo ID
Tham số đường dẫn
Tên Loại Bắt buộc Mô tả
transaction_id
integer Bắt buộc
ID của một giao dịch

Tên	Loại	Bắt buộc	Mô tả
`transaction_id`	integer	Bắt buộc	ID của một giao dịch

bash

RESPONSE

{
  "status": 200,
  "error": null,
  "messages": {
    "success": true
  },
  "transaction": {
    "id": "48673",
    "transaction_date": "2023-05-04 11:59:47",
    "account_number": "0071000888888",
    "sub_account": "VCB0011ABC002",
    "amount_in": "19689000.00",
    "amount_out": "0.00",
    "accumulated": "1128200335.00",
    "code": null,
    "transaction_content": "TRAN THIEN THAO chuyen tien...",
    "reference_number": "731086.040523.120001",
    "bank_brand_name": "Vietcombank",
    "bank_account_id": "19"
  }
}

Đếm số lượng giao dịch

GET

/userapi/transactions/count

Content-Type: application/json
Authorization: Bearer {YOUR_API_TOKEN}

Đếm tổng số lượng giao dịch.
Tham số truy vấn

Tên	Loại	Bắt buộc	Mô tả
`account_number`	string	Không bắt buộc	Số tài khoản ngân hàng
`transaction_date_min`	string	Không bắt buộc	Hiển thị các giao dịch được tạo sau thời gian (>=). Định dạng yyyy-mm-dd
`transaction_date_max`	string	Không bắt buộc	Hiển thị các giao dịch được tạo trước thời gian (<=). Định dạng yyyy-mm-dd
`since_id`	integer	Không bắt buộc	Hiển thị giao dịch từ ID chỉ định (>=)

Ví dụ sử dụng

Đếm tổng số lượng giao dịch của tài khoản ngân hàng 0071000888888.

cURL

curl -X GET "https://my.sepay.vn/userapi/transactions/count?account_number=0071000888888" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"