Phương Thức Thanh Toán

​

Các Phương Thức Thanh Toán Hỗ Trợ

​

Chi Tiết Phương Thức Thanh Toán

​

Cấu Hình Các Phương Thức Thanh Toán

​

Khi Nào Cấu Hình Các Phương Thức Thanh Toán

• Kiểm soát các tùy chọn thanh toán nào xuất hiện với khách hàng dựa trên yêu cầu kinh doanh của bạn
• Hạn chế các phương thức thanh toán cho các loại sản phẩm hoặc quy trình giao dịch cụ thể
• Duy trì tính nhất quán giữa các trải nghiệm thanh toán khác nhau
• Tối ưu hóa trải nghiệm thanh toán cho đối tượng mục tiêu của bạn

​

Triển Khai

{
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay"
  ]
}

​

Các Điểm Cuối API

​

Ví Dụ Triển Khai

{
  "amount": 1000,
  "currency": "usd",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay",
    "google_pay"
  ]
}

{
  "product_id": "prod_123",
  "customer_id": "cust_456",
  "allowed_payment_method_types": [
    "credit",
    "debit"
  ]
}

{
  "amount": 5000,
  "currency": "eur",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "ideal",
    "bancontact",
    "sepa"
  ]
}

​

Các Thực Hành Tốt Nhất

​

Các Cân Nhắc Quan Trọng

• Vị Trí Khách Hàng: Một số phương thức thanh toán là cụ thể theo vùng
• Cài Đặt Thương Nhân: Cấu hình và khả năng của tài khoản của bạn
• Đồng Tiền: Các phương thức thanh toán được hỗ trợ thay đổi theo đồng tiền
• Loại Giao Dịch: Một số phương thức không hỗ trợ đăng ký hoặc có số tiền tối thiểu

​

Khắc Phục Sự Cố

// Update payment method for active subscription
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

// For on_hold subscription - automatically creates charge
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

​

Mở Rộng Các Tùy Chọn Thanh Toán