Thẻ tín dụng & thẻ ghi nợ

​

Mạng lưới thẻ được hỗ trợ

​

Mạng lưới toàn cầu

​

Mạng lưới theo khu vực

​

Cấu hình

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['credit', 'debit'],
  return_url: 'https://example.com/success'
});

​

Xác thực 3D Secure

​

Khi 3DS được kích hoạt

• Được mạng lưới thẻ yêu cầu
• Được quy định theo quy định pháp luật của khu vực (ví dụ: PSD2 tại châu Âu)
• Giao dịch bị đánh dấu là có rủi ro cao

​

Bắt buộc 3DS

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  force_3ds: true,
  return_url: 'https://example.com/success'
});

​

Xử lý lỗi xác thực

• AUTHENTICATION_FAILURE — không thể xác thực khách hàng.
• AUTHENTICATION_REQUIRED — yêu cầu xác thực nhưng chưa được thực hiện.
• AUTHENTICATION_TIMEOUT — khách hàng không phản hồi kịp thời.

​

Tại checkout và khi gia hạn

• Tại checkout (khách hàng có mặt): Khách hàng đang có mặt, vì vậy thử thách 3DS được hiển thị trong quá trình checkout. Nếu thất bại, hãy yêu cầu họ thử lại hoặc sử dụng thẻ khác.
• Khi gia hạn gói đăng ký (khách hàng không có mặt): Khách hàng không có mặt, vì vậy không thể hiển thị thử thách 3DS theo thời gian thực. Nếu một lần gia hạn yêu cầu xác thực, gói đăng ký sẽ chuyển sang on_hold. Khôi phục bằng cách nhắc khách hàng quay lại và cập nhật phương thức thanh toán — xem Xử lý lỗi thanh toán và Dunning gói đăng ký.

​

Phương thức thanh toán đã lưu

​

Bật thẻ đã lưu

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  show_saved_payment_methods: true,
  customer: { customer_id: 'cus_existing_123' },
  return_url: 'https://example.com/success'
});

​

Mua hàng một lần nhấp

// Get customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Use saved card for instant checkout
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  payment_method_id: methods.items[0].payment_method_id,
  confirm: true,
  return_url: 'https://example.com/success'
});

​

Kiểm thử

​

Bảo mật & tuân thủ

​

Thực tiễn tốt nhất

​

Khắc phục sự cố

​

Trang liên quan