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.

API Rate Limits

Pay2S giới hạn số lần request đến là 60 lần/ 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 chi tiết giao dịch

Method

Method: POST

Endpoint

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

Header

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

• pay2s-token: Định dạng Base64 từ Secret Key. Mã này được sinh ra khi đăng ký tài khoản thành công. Xem tại Tích hợp Web/App.

Request Parameters

Key	Type	Required	Description
bankAccounts	String	✓	Chứa tài khoản ngân hàng cần lấy (Bỏ qua trường này nếu muốn lấy tất cả ngân hàng trong tài khoản)
begin	String	✓	Ngày bắt đầu.
end	String	✓	Ngày kết thúc.

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"
    },
    {
     "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"
    },
    ...
  ]
}

Key	Description
id	ID giao dịch duy nhất trên hệ thống Pay2S
transaction_date	Ngày giao dịch
transaction_id	Mgã giao dịch ngân hàng phát sinh
account_number	Số tài khoản ngân hàng phát sinh
bank	BankCode ngân hàng phát sinh
amount	Số tiền giao dịch
description	Nội dung giao dịch
type	Loại giao dịch: Tiền ra (OUT), tiền vào (IN)