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ã đơ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

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
Tình trạng thanh toán.
ví dụ: "completed"

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

orderId: số
Mã đơ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 nhà cung cấp thanh toán (ví dụ: Stripe) trả về khi tạo phiên.
ví dụ: "pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH"

Ví dụ sử dụng

Hướng dẫn từng bước trong tài liệu:

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.

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.

Mô tả​

Sơ đồ tham số​

Ví dụ​

Ví dụ tối thiểu​

Ví dụ phản hồi​

Sơ đồ phản hồi​

Ví dụ sử dụng​

Thử nghiệm trực tiếp​