Nhảy đến nội dung

createSession

Tạo 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 tạo 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 ICreateSessionEntity.

Payments.createSession(

orderId*, type*, automaticTaxEnabled

);

Sơ đồ tham số

Sơ đồ

orderId(bắt buộc): số
Mã định danh đơn hàng
ví dụ: 12345

type(bắt buộc): 'session' | 'intent'
Loại phiên. Các giá trị có thể: "session" hoặc "intent"
ví dụ: 'session'

automaticTaxEnabled: boolean
Tính toán tự động tỷ lệ thuế. Mặc định: false
ví dụ: false

Thử nghiệm trực tiếp

Chạy phương thức này một cách tương tác trong JS SDK sandbox — kết nối URL Dự án và Mã thông báo Ứng dụng của bạn khi truy cập lần đầu, sau đó mở:

  • Thanh toán đơn hàng — tạo một phiên thanh toán cho một đơn hàng được đặt bởi người dùng đã đăng ký.
  • Đặt vé — quy trình thanh toán vé đầy đủ: tạo đơn hàng, sau đó bắt đầu phiên thanh toán.
  • Đặt hàng khách — quy trình thanh toán cho khách với việc tạo phiên thanh toán.

Ví dụ

Ví dụ tối thiểu

const response = await Payments.createSession(1, 'session');

Ví dụ phản hồi

{
"id": 1764,
"type": "session",
"status": "completed",
"orderId": 1,
"paymentAccountId": 1,
"paymentUrl": "https://checkout.stripe.com/c/pay/cs_test_...nP3F3cGB4JSUl",
"createdDate": "2026-02-06T03:16:19.337Z",
"updatedDate": "2026-02-06T05:15:24.932Z",
"amount": 4061.55,
"clientSecret": "pi_3Mtw...ZluoGH"
}

Sơ đồ phản hồi

Sơ đồ: ICreateSessionEntity

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

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

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

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

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

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

orderId: số
Mã định danh đơn hàng.
ví dụ: 1

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

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

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