# Tài liệu Pay2S đính kèm
Ngày chụp nội dung tài liệu: 2026-09-29 (UTC).
Nguồn: https://docs.pay2s.vn/
Đây là bản tài liệu lưu tại ngày trên, không tự cập nhật sau khi tải. Nội dung các trang được chép đầy đủ bên dưới; không cần mở link để đọc. Các liên kết khác là nguồn tham khảo bổ sung. Nếu thiếu thông tin cần thiết, hãy hỏi người dùng thay vì tự đoán.
## Mục lục
- 💳 API Giao Dịch
---
Nguồn trang: https://docs.pay2s.vn/history-api/tai-lieu-ky-thuat.html
# 💳 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
:::: warning 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
```json
{
"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](https://pay2s.vn/client/integration/webapp).
### 📥 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
```json
{
"bankAccounts": "737478888",
"begin": "03/08/2024",
"end": "03/08/2024"
}
```
### 📤 Sample Response
```json
{
"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|