💳 API Giao Dịch

API 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.

🚦 Giới hạn truy cập

API Rate Limits

Hệ thống Pay2S giới hạn tối đa 60 request/phút. Nếu vượt quá giới hạn này, sẽ trả về lỗi:

429 Too Many Requests

📌 API: Lấy danh sách giao dịch

Method

Method: POST

🔗 Endpoint

https://api.pay2s.vn/userapi/transactions

🔐 Header

{
  "Content-Type": "application/json",
  "pay2s-token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."
}

• pay2s-token: Là chuỗi token base64 từ SecretKey, tạo khi đăng ký tài khoản thành công. Bạn có thể xem tại: Xem tại Tích hợp Web/App.

📥 Request Parameters

Key	Type	Required	Description
bankAccounts	String	✓	Số tài khoản muốn lọc giao dịch. Bỏ qua để lấy tất cả.
begin	String	✓	Ngày bắt đầu (định dạng: dd/mm/yyyy)
end	String	✓	Ngày kết thúc (định dạng: dd/mm/yyyy)

🧪 Sample Request

{
  "bankAccounts": "737478888",
  "begin": "03/08/2024",
  "end": "03/08/2024"
}

📤 Sample Response

{
  "status" : true,
  "messages" : "Thành công",
  "transactions": [
    {
      "id": 2288,
      "transaction_date": "2024-08-03 02:23:11",
      "transaction_id": "10439",
      "account_number": "737478888",
      "bank": "ACB",
      "amount": 2000,
      "description": "QR - GP2BKPT410 GD 750915-080324 02:23:07",
      "type": "IN",
      "checksum": "861aa38ef4f0309b9204a0345af0b445",
      "detail": {
                "remitterName": "HUYNH TAN CHAU",
                "remitterAccountNumber": "0938587885",
                "issuerBankName": "TMCP Quan Doi",
                "reciprocalBankCode": null
      }
    },
    {
     "id": 2287,
      "transaction_date": "2024-08-03 02:12:41",
      "transaction_id": "10438",
      "account_number": "737478888",
      "bank": "ACB",
      "amount": 2000,
      "description": "GP7O2HW8Y5 GD 963294-080324 02:12:39",
      "type": "IN",
      "checksum": "7e2b3bbc03d1083017e3d2a96d3b8e01",
      "detail": {
                "remitterName": "LE ANH HOANG",
                "remitterAccountNumber": "9386211098",
                "issuerBankName": "TMCP Quan Doi",
                "reciprocalBankCode": null
      }
    },
    ...
  ]
}

Key	Description
id	ID giao dịch duy nhất trên hệ thống Pay2S
transaction_date	Thời gian giao dịch (YYYY-MM-DD HH:mm:ss)
transaction_id	Mã giao dịch gốc từ phía ngân hàng
account_number	Số tài khoản ngân hàng nhận/gửi tiền
bank	BankCode (ví dụ: ACB, VCB...)
amount	Số tiền giao dịch (đơn vị: VNĐ)
description	Nội dung chuyển khoản
type	Loại giao dịch: IN (nhận tiền), OUT (chuyển tiền)
checksum	Mã duy nhất của giao dịch được sinh ra từ Pay2S