Nhảy tới nội dung
Phiên bản: Lastest

Lấy danh sách giao dịch

API lấy danh sách giao dịch​

EndPoint​

GET /api/v2/orders/transactions

Header Params​

Tham sốYêu cầuKiểu dữ liệuMô tả
X-APPOTAPAY-AUTHrequiredString Cách tạo JWT_TOKEN
Content-TyperequiredStringGiá trị: application/json
{
    "X-APPOTAPAY-AUTH": "Bearer JWT_TOKEN",
    "Content-Type": "application/json"
}

Request Params​

Tham sốYêu cầuKiểu dữ liệuMô tả
startTimeoptionalIntegerThời gian bắt đầu (bắt buộc khi có thời gian kết thúc)
endTimeoptionalIntegerThời gian kết thúc (bắt buộc khi có thời gian bắt đầu)
statusoptionalStringTrạng thái giao dịch muốn tìm kiếm
paymentMethodoptionalStringPhương thức thanh toán muốn tìm kiếm
limitoptionalIntegerTối thiểu là 1, tối đa là 50 (không truyền mặc định là 15)
pageoptionalIntegerTối thiểu là 1 (không truyền mặc định là 1)

Response Params​

Tham sốYêu cầuKiểu dữ liệuMô tả
paginationrequiredObjectThông tin phân trang
pagination.totalrequiredIntegerTổng số bảng ghi
pagination.pagerequiredIntegerPage hiện tại
pagination.limitrequiredIntegerLimit hiện tại
transactionsrequiredArrayDanh sách giao dịch

Thành công​

Http Status Code 200 - OK

Example Response​

{
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 15
  },
  "transactions": [
    {
      "errorCode": 0,
      "status": "success",
      "amount": 1000000,
      "currency": "VND",
      "orderId": "9MOmaZigD",
      "bankCode": "MASTERCARD",
      "paymentMethod": "CC",
      "paymentType": "WEB",
      "appotapayTransId": "AP241447565422",
      "transactionTs": 1715848036,
      "extraData": "CPM"
    }
  ]
}

Thất bại​

HTTP Status Code != 200 Với errorCode trả về, vui lòng tham khảo bảng mã lỗi tại đây

Ví dụ Code​

curl  "https://gateway.dev.appotapay.com/api/v2/orders/transactions?startTime=1715848036&endTime=1715848036&limit=15&page=1" \
  -H "X-APPOTAPAY-AUTH: JWT_TOKEN" \
  -H "Content-Type: application/json"

Request​

REQUEST

Development server