getSessions

Lấy danh sách các phiên thanh toán. 🔐 Phương thức này yêu cầu ủy quyền.

Mô tả

Phương thức này lấy danh sách một phiên thanh toán. Nó trả về một Promise mà khi hoàn thành sẽ trả về một đối tượng phiên thanh toán ISessionsEntity.

Payments.getSessions(

offset, limit

);

Sơ đồ tham số

Sơ đồ

offset: number
Tham số tùy chọn cho phân trang. Mặc định: 0
ví dụ: 0

limit: number
Tham số tùy chọn cho phân trang. Mặc định: 30
ví dụ: 30

Mặc định, bạn có thể lấy 10 đối tượng. Điều này là do giới hạn số bản ghi trong cài đặt quyền của mô-đun.
Để phân trang hoạt động chính xác, bạn cần cấu hình Quyền mô-đun theo nhu cầu của bạn trong phần tương ứng.

Ví dụ

Ví dụ tối thiểu

const response = await Payments.getSessions();

Ví dụ với các thuộc tính

const response = await Payments.getSessions(0, 30);

Ví dụ phản hồi

{
  "items": [
    {
      "id": 48,
      "createdDate": "2026-04-10T11:44:56.426Z",
      "updatedDate": "2026-04-10T11:44:56.426Z",
      "type": "session",
      "status": "waiting",
      "paymentAccountId": 1,
      "orderId": 220,
      "amount": null,
      "paymentUrl": null
    },
    {
      "id": 47,
      "createdDate": "2025-11-06T06:42:12.463Z",
      "updatedDate": "2025-11-06T06:42:12.463Z",
      "type": "session",
      "status": "waiting",
      "paymentAccountId": 3,
      "orderId": 205,
      "amount": 50,
      "paymentUrl": "https://checkout.stripe.com/c/pay/cs_test_a19RuP9hh4gGmaSOQwb57OBpnypIifa0FDnGhYe7od5XkRXRUpYXUKDRtm#fidnandhYHdWcXxpYCc%2FJ2FgY2RwaXEnKSd2cXdsdWBEZmZqcGtxJz8nZGZmcVo0VHJuTndEZlZqS2YybGBzJyknZHVsTmB8Jz8ndW5acWB2cVowNEtDcERXRG9vaE89NUZTa2tDan1AdkJNaHN2YnE2Tmw8YE5zVUJCb1ZTYXBkQEBgSXNkZ3JTVj1UbmZDUTVVTXA0cH1CMkZXXDVfUUM0YUJRQTVLTGZPbjU1d0tkcmFoNV8nKSdjd2poVmB3c2B3Jz9xd3BgKSdnZGZuYndqcGthRmppancnPycmY2NjY2NjJyknaWR8anBxUXx1YCc%2FJ3Zsa2JpYFpscWBoJyknYGtkZ2lgVWlkZmBtamlhYHd2Jz9xd3BgeCUl"
    },
    {
      "id": 46,
      "createdDate": "2025-11-05T11:41:05.450Z",
      "updatedDate": "2025-11-06T06:42:12.457Z",
      "type": "session",
      "status": "canceled",
      "paymentAccountId": 3,
      "orderId": 205,
      "amount": 50,
      "paymentUrl": "https://checkout.stripe.com/c/pay/cs_test_a13zyOnaZK22i261vea98XHczmJnyl4e3FuPOtOQRougzYxnkScUQAFmU0#fidnandhYHdWcXxpYCc%2FJ2FgY2RwaXEnKSd2cXdsdWBEZmZqcGtxJz8nZGZmcVo0VHJuTndEZlZqS2YybGBzJyknZHVsTmB8Jz8ndW5acWB2cVowNEtDcERXRG9vaE89NUZTa2tDan1AdkJNaHN2YnE2Tmw8YE5zVUJCb1ZTYXBkQEBgSXNkZ3JTVj1UbmZDUTVVTXA0cH1CMkZXXDVfUUM0YUJRQTVLTGZPbjU1d0tkcmFoNV8nKSdjd2poVmB3c2B3Jz9xd3BgKSdnZGZuYndqcGthRmppancnPycmY2NjY2NjJyknaWR8anBxUXx1YCc%2FJ3Zsa2JpYFpscWBoJyknYGtkZ2lgVWlkZmBtamlhYHd2Jz9xd3BgeCUl"
    },
    "..."
  ],
  "total": 44
}

Sơ đồ phản hồi

Sơ đồ: ISessionsEntity

total: number
Tổng số bản ghi được tìm thấy.
ví dụ: 100

items: ISessionEntity[]
Mảng các đối tượng phiên.
ví dụ:

[
  {
    "id": 27,
    "createdDate": "2025-06-04T04:38:32.849Z",
    "updatedDate": "2025-06-04T04:38:32.849Z",
    "type": "session",
    "status": "waiting",
    "paymentAccountId": 1,
    "orderId": 55,
    "paymentUrl": null
  }
]

items.id: number
Định danh đối tượng.
ví dụ: 1764

items.createdDate: string
Ngày tạo đối tượng.
ví dụ: "2025-02-26T10:13:16.839Z"

items.updatedDate: string
Ngày sửa đổi đối tượng.
ví dụ: "2025-02-26T10:13:16.839Z"

items.type: 'session' | 'intent'
Loại có thể là 'session' hoặc 'intent'.
ví dụ: "session"

items.status: string
Trạng thái thanh toán.
ví dụ: "completed"

items.paymentAccountId: number
Định danh tài khoản thanh toán.
ví dụ: 1

items.orderId: number
Định danh đơn hàng.
ví dụ: 1

items.paymentUrl: string | null
Liên kết thanh toán.
ví dụ: " https://www.sandbox.paypal.com/checkoutnow?token=9BE88048TU058770M"

items.amount: number | null
Số tiền của phiên thanh toán.
ví dụ: 100

items.clientSecret: string
Khóa bí mật của khách hàng được nhà cung cấp thanh toán (ví dụ: Stripe) trả về khi tạo một phiên.
ví dụ: "pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH"

---