Tài liệu API Payment

Lịch sử giao dịch V2
Xem tài liệu V3 Trang chủ

ICB - Endpoint

Endpoint:
https://web.ducyuz.com/historyapicbv2/{token}
Phương thức HTTP:GET
Parameters (Optional): ?rows=20 Số lượng giao dịch trả về (mặc định: 20, tối đa: 100)
Mô tả:

Trả về danh sách giao dịch tài khoản ACB theo token được cấp.

Định dạng phản hồi:JSON

ACB - Phản hồi mẫu

✅ Thành công (200 OK):

{
  "status": "success",
  "msg": "Thành công",
  "transactions": [
    {
      "transactionID": 2925,
      "amount": 135000,
      "description": "IB 4ZR5WDCR",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    },
    {
      "transactionID": 2924,
      "amount": 32700,
      "description": "VO THI QUYNH MY CHUYEN KHOAN-020925-16:53:23 670714",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    }
  ]
}

❌ Lỗi phổ biến:

Token không hợp lệ (404):
{"status": "error", "msg": "Token không hợp lệ", "transactions": []}
API đang tắt (200):
{"status": "error", "msg": "API đang tắt", "transactions": []}
Gói đã hết hạn (200):
{"status": "error", "msg": "Gói đã hết hạn", "transactions": []}

ACB - Endpoint

Endpoint:
https://web.ducyuz.com/historyapiacbv2/{token}
Phương thức HTTP:GET
Parameters (Optional): ?rows=20 Số lượng giao dịch trả về (mặc định: 20, tối đa: 100)
Mô tả:

Trả về danh sách giao dịch tài khoản ACB theo token được cấp.

Định dạng phản hồi:JSON

ACB - Phản hồi mẫu

✅ Thành công (200 OK):

{
  "status": "success",
  "msg": "Thành công",
  "transactions": [
    {
      "transactionID": 2925,
      "amount": 135000,
      "description": "IB 4ZR5WDCR",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    },
    {
      "transactionID": 2924,
      "amount": 32700,
      "description": "VO THI QUYNH MY CHUYEN KHOAN-020925-16:53:23 670714",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    }
  ]
}

❌ Lỗi phổ biến:

Token không hợp lệ (404):
{"status": "error", "msg": "Token không hợp lệ", "transactions": []}
API đang tắt (200):
{"status": "error", "msg": "API đang tắt", "transactions": []}
Gói đã hết hạn (200):
{"status": "error", "msg": "Gói đã hết hạn", "transactions": []}

zalo - Endpoint

Endpoint:
https://web.ducyuz.com/historyapizalov2/{token}
Phương thức HTTP:GET
Parameters (Optional): ?rows=20 Số lượng giao dịch trả về (mặc định: 20, tối đa: 100)
Mô tả:

Trả về danh sách giao dịch tài khoản ACB theo token được cấp.

Định dạng phản hồi:JSON

ACB - Phản hồi mẫu

✅ Thành công (200 OK):

{
  "status": "success",
  "msg": "Thành công",
  "transactions": [
    {
      "transactionID": 2925,
      "amount": 135000,
      "description": "IB 4ZR5WDCR",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    },
    {
      "transactionID": 2924,
      "amount": 32700,
      "description": "VO THI QUYNH MY CHUYEN KHOAN-020925-16:53:23 670714",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    }
  ]
}

❌ Lỗi phổ biến:

Token không hợp lệ (404):
{"status": "error", "msg": "Token không hợp lệ", "transactions": []}
API đang tắt (200):
{"status": "error", "msg": "API đang tắt", "transactions": []}
Gói đã hết hạn (200):
{"status": "error", "msg": "Gói đã hết hạn", "transactions": []}

TCB - Endpoint

Endpoint:
https://web.ducyuz.com/historyapitechv2/{token}
Phương thức HTTP:GET
Parameters (Optional): ?rows=20 Số lượng giao dịch trả về (mặc định: 20, tối đa: 100)
Mô tả:

Trả về danh sách giao dịch tài khoản ACB theo token được cấp.

Định dạng phản hồi:JSON

ACB - Phản hồi mẫu

✅ Thành công (200 OK):

{
  "status": "success",
  "msg": "Thành công",
  "transactions": [
    {
      "transactionID": 2925,
      "amount": 135000,
      "description": "IB 4ZR5WDCR",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    },
    {
      "transactionID": 2924,
      "amount": 32700,
      "description": "VO THI QUYNH MY CHUYEN KHOAN-020925-16:53:23 670714",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    }
  ]
}

❌ Lỗi phổ biến:

Token không hợp lệ (404):
{"status": "error", "msg": "Token không hợp lệ", "transactions": []}
API đang tắt (200):
{"status": "error", "msg": "API đang tắt", "transactions": []}
Gói đã hết hạn (200):
{"status": "error", "msg": "Gói đã hết hạn", "transactions": []}

VT - Endpoint

Endpoint:
https://web.ducyuz.com/historyapivtpv2/{token}
Phương thức HTTP:GET
Parameters (Optional): ?rows=20 Số lượng giao dịch trả về (mặc định: 20, tối đa: 100)
Mô tả:

Trả về danh sách giao dịch tài khoản ACB theo token được cấp.

Định dạng phản hồi:JSON

ACB - Phản hồi mẫu

✅ Thành công (200 OK):

{
  "status": "success",
  "msg": "Thành công",
  "transactions": [
    {
      "transactionID": 2925,
      "amount": 135000,
      "description": "IB 4ZR5WDCR",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    },
    {
      "transactionID": 2924,
      "amount": 32700,
      "description": "VO THI QUYNH MY CHUYEN KHOAN-020925-16:53:23 670714",
      "transactionDate": "2025-09-03",
      "type": "OUT"
    }
  ]
}

❌ Lỗi phổ biến:

Token không hợp lệ (404):
{"status": "error", "msg": "Token không hợp lệ", "transactions": []}
API đang tắt (200):
{"status": "error", "msg": "API đang tắt", "transactions": []}
Gói đã hết hạn (200):
{"status": "error", "msg": "Gói đã hết hạn", "transactions": []}

Thông tin chung

🔒 Bảo mật:

  • • Token được cấp riêng cho từng tài khoản
  • • Chỉ tài khoản đã xác thực mới có token
  • • API tự động tắt khi status = inactive
  • • V3 mới: Xác thực 3 lớp (Password + Số TK + Token)

⚡ Rate Limiting:

  • • Tối đa 100 giao dịch mỗi request
  • • Không giới hạn số request/phút
  • • Auto-sync với ngân hàng real-time

📝 Ghi chú:

  • • Dữ liệu giao dịch được cập nhật real-time
  • • Format ngày tháng khác nhau theo từng ngân hàng
  • • Type: "IN" = Tiền vào, "OUT" = Tiền ra

🔄 Support:

  • • Content-Type: application/json
  • • Encoding: UTF-8
  • • CORS: Được phép từ mọi origin
ZaloTelegram