Thanh Toán B2B

Thanh toán B2B cho phép bạn thu thập Tax ID và tên doanh nghiệp trong quá trình thanh toán, xác thực Tax ID và áp dụng cách xử lý thuế phù hợp dựa trên quốc gia và quy định áp dụng cho khách hàng.

Xác thực Tax ID cho giao dịch B2B

Khi cung cấp Tax ID hợp lệ trong quá trình thanh toán:

Hóa đơn bao gồm Tax ID của khách hàng.
Các khoản khấu trừ thuế được xác định dựa trên quy định áp dụng cho quốc gia của khách hàng.
Hóa đơn bao gồm thông tin thuế của Dodo Payments và khoản thuế áp dụng cho giao dịch.

Thu thập tên doanh nghiệp cho hóa đơn B2B

Đối với giao dịch mua B2B, bạn có thể hiển thị tên doanh nghiệp pháp lý của khách hàng trên hóa đơn thay cho tên cá nhân của người mua. Thông tin này được thu thập cùng với Tax ID thông qua trường customer_business_name. Khi khách hàng chọn Mua hàng với tư cách doanh nghiệp trong quá trình thanh toán, họ sẽ được yêu cầu nhập cả Business Name và Tax ID Number. Tax ID được xác thực trực tiếp khi khách hàng nhập. Đối với các quốc gia thành viên EU, Great Britain và Australia, quy trình thanh toán thực hiện cả xác thực định dạng và checksum, đồng thời tra cứu trực tiếp trong cơ sở dữ liệu đăng ký (lần lượt là VIES, HMRC và ABR) rồi tự động điền tên doanh nghiệp pháp lý đã đăng ký khi tìm thấy kết quả khớp. Đối với tất cả quốc gia khác, chỉ thực hiện xác thực định dạng và checksum.

Trang thanh toán với tùy chọn 'Mua hàng với tư cách doanh nghiệp' được bật, hiển thị các trường Business Name và Tax ID Number

Tên doanh nghiệp chỉ xuất hiện trên hóa đơn khi đáp ứng cả ba điều kiện sau:

Giao dịch là B2B (b2b = true).
Có tax_id.
Cung cấp customer_business_name không rỗng.

Nếu không đáp ứng bất kỳ điều kiện nào, tên cá nhân của khách hàng sẽ được sử dụng thay thế.

Thiết lập trong quá trình thanh toán

Truyền trực tiếp customer_business_name và/hoặc bật allow_customer_editing_business_name để cho phép khách hàng nhập hoặc chỉnh sửa thông tin này trên trang thanh toán bên cạnh Tax ID của họ:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { email: 'buyer@acme.com' },
  tax_id: 'GB123456789',
  customer_business_name: 'Acme Corp Ltd',
  feature_flags: {
    allow_tax_id: true,
    allow_customer_editing_business_name: true // optional: let the customer edit it
  },
  return_url: 'https://yoursite.com/return'
});

Bề mặt	Trường	Ghi chú
Checkout Sessions	`customer_business_name`, `feature_flags.allow_customer_editing_business_name`	Tối đa 250 ký tự; flag mặc định là `false`
Payments	`customer_business_name`	Tối đa 250 ký tự
Subscriptions	`customer_business_name`	Thiết lập hoặc xóa thông qua `PATCH /subscriptions/{subscription_id}`

Không thể thiết lập customer_business_name nếu không có tax_id — request sẽ bị từ chối. Việc xóa tax_id cũng xóa tên doanh nghiệp, vì hai thông tin này được liên kết với nhau trên hóa đơn. Khoảng trắng ở đầu và cuối sẽ được loại bỏ, còn các giá trị chỉ chứa khoảng trắng được xem là thao tác xóa rõ ràng.

Bắt buộc Tax ID

Theo mặc định, Tax ID là tùy chọn — khách hàng quyết định có mua hàng với tư cách doanh nghiệp hay không. Nếu bạn chỉ bán hàng cho các doanh nghiệp đã đăng ký, hãy đặt feature flag require_tax_id trên checkout session để bắt buộc thông tin này:

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { email: 'buyer@acme.com' },
  billing_address: { country: 'IN' },
  feature_flags: {
    allow_tax_id: true,   // default; must be true
    require_tax_id: true
  },
  return_url: 'https://yoursite.com/return'
});

Những thay đổi trong quá trình thanh toán

Mua hàng với tư cách doanh nghiệp được chọn trước và không thể bỏ chọn. Các session này không có tùy chọn mua với tư cách cá nhân.
Business Name và Tax ID Number đều được đánh dấu là bắt buộc và phải được điền.
Continue to Payment vẫn bị làm mờ khi một trong hai trường còn trống hoặc khi Tax ID đã nhập bị từ chối trong quá trình xác thực.

Việc xác thực Tax ID vẫn theo cơ chế fail-open — sự cố khi tra cứu hoặc quốc gia không được hỗ trợ sẽ không chặn khách hàng, vì vậy nút vẫn có thể nhấp ngay cả khi đang bị làm mờ.

Truyền tax_id và customer_business_name trong session sẽ điền sẵn cả hai trường, đáp ứng yêu cầu trước khi khách hàng tương tác với biểu mẫu. Bỏ qua các trường này nếu bạn muốn khách hàng tự cung cấp thông tin.

Quy tắc và giới hạn

Quy tắc	Hành vi
`require_tax_id: true` với `allow_tax_id: false`	Bị từ chối với `400` — flag sẽ yêu cầu một trường mà checkout không bao giờ hiển thị
`require_tax_id: true` với `confirm: true`	Bị từ chối với `422` trừ khi request bao gồm `tax_id` không trống, vì `confirm` bỏ qua trang checkout
Bỏ qua flag	Mặc định là `false`; các session và integration hiện có không bị ảnh hưởng

tax_id trống hoặc chỉ chứa khoảng trắng được xem là bị thiếu, cả trong guard confirm: true lẫn khi xác nhận hosted-page session.

Trên trang hosted checkout (confirm: false), yêu cầu này được thực thi trong trình duyệt. API từ chối Tax ID trống khi xác nhận, nhưng không thể phân biệt người mua cá nhân với người mua doanh nghiệp đã bỏ qua trường này. Vì vậy, hãy xem require_tax_id trên các hosted session là cơ chế kiểm soát trải nghiệm checkout thay vì đảm bảo rằng mọi payment đều có Tax ID. Session confirm: true là trường hợp nghiêm ngặt hơn: session này luôn được xem là giao dịch mua của doanh nghiệp và sẽ bị từ chối hoàn toàn nếu không có Tax ID.

Xử lý thuế cho giao dịch B2C

Các giao dịch không cung cấp Tax ID hợp lệ được xem là giao dịch B2C và thuế được khấu trừ theo quy định thuế áp dụng tại quốc gia của khách hàng. Hóa đơn bao gồm thông tin thuế của Dodo Payments và khoản thuế áp dụng cho giao dịch.

Cơ chế Reverse Charge

Thông thường, nhà cung cấp hàng hóa hoặc dịch vụ có trách nhiệm nộp VAT, Service Tax hoặc GST. Tuy nhiên, trong các trường hợp cụ thể như hàng nhập khẩu và các giao dịch cung ứng thuộc diện được thông báo, trách nhiệm này thuộc về bên nhận (khách hàng) theo cơ chế reverse charge. Reverse Charge có nghĩa là trách nhiệm nộp thuế thuộc về bên nhận hàng hóa hoặc dịch vụ thay vì nhà cung cấp đối với các danh mục cung ứng được thông báo.

Khả năng áp dụng Reverse Charge

Trong một số trường hợp được pháp luật cho phép, thuế không được khấu trừ tại thời điểm thanh toán và giao dịch chịu cơ chế reverse charge. Hóa đơn sẽ nêu rõ khi reverse charge được áp dụng, theo yêu cầu của quy định pháp luật.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Xác thực Tax ID cho giao dịch B2B

Thu thập tên doanh nghiệp cho hóa đơn B2B

Thiết lập trong quá trình thanh toán

Bắt buộc Tax ID

Những thay đổi trong quá trình thanh toán

Quy tắc và giới hạn

Xử lý thuế cho giao dịch B2C

Cơ chế Reverse Charge

Khả năng áp dụng Reverse Charge

​Xác thực Tax ID cho giao dịch B2B

​Thu thập tên doanh nghiệp cho hóa đơn B2B

​Thiết lập trong quá trình thanh toán

​Bắt buộc Tax ID

​Những thay đổi trong quá trình thanh toán

​Quy tắc và giới hạn

​Xử lý thuế cho giao dịch B2C

​Cơ chế Reverse Charge

​Khả năng áp dụng Reverse Charge

Xác thực Tax ID cho giao dịch B2B

Thu thập tên doanh nghiệp cho hóa đơn B2B

Thiết lập trong quá trình thanh toán

Bắt buộc Tax ID

Những thay đổi trong quá trình thanh toán

Quy tắc và giới hạn

Xử lý thuế cho giao dịch B2C

Cơ chế Reverse Charge

Khả năng áp dụng Reverse Charge