FAQ
Why a pay page after the order, and not card fields on the checkout page? The order (and its total) exists before anything is charged, so the amount that 3D Secure authenticates and the amount that is charged are the same, the CS-Cart checkout keeps working with every theme and one-step checkout add-on, and a repay of an unpaid order uses the same page.
Why Hosted Fields and not the Drop-in UI? Braintree’s Drop-in overview says: “Starting October 1, 2026, the Drop-in SDK will be deprecated”, and asks merchants to migrate to the Braintree JavaScript SDK. Hosted Fields is part of that SDK.
Do card numbers touch my server? No. They are typed into iframes hosted by Braintree; your store only receives a single-use token (nonce).
Which currencies? Those your Braintree merchant accounts settle in. Each account has one currency. Orders in another currency can be charged in your default merchant account, converted with your store rate. Currencies Braintree does not list, or whose decimals Braintree and ISO 4217 disagree on (LAK), are not offered.
Can I refund right after the order? Braintree refunds only payments that are settling or settled. Before that, use Void (the customer is not charged at all).
Can I capture in several parts? 1.0 captures an authorization once (full or a lower amount). Multiple partial captures are a PayPal-only Braintree feature.
Apple Pay, Google Pay, Venmo, saved cards? Not in 1.0.
Do I need webhooks? They are recommended for disputes and settlement results. Payments work without them: card answers are synchronous, and the cron reads unclear payments and settlements back.
Does it work with the full page cache of CS-Cart 4.21? Yes. The pay page, the payment return and the webhook are not cacheable pages, and the pay page is sent with “Cache-Control: no-store”.
Does it change core files? No. Hooks, its own controllers and templates only.
My license shows “Pending verification”
Section titled “My license shows “Pending verification””This status appears in older add-on versions when you use a CS-Cart Marketplace license number that our license server has not matched with the Marketplace yet. The add-on is fully working in this state: no feature is switched off and you do not need to do anything. Newer versions show it as Active (Marketplace license). We confirm Marketplace numbers on our side; click Check now on the add-on’s License tab (Add-ons → Manage add-ons → the add-on) a little later and it shows Active. If it has not changed after 24 hours, contact support with your Marketplace order number.
Still stuck?
Section titled “Still stuck?”Work through the troubleshooting guide, then contact support with your CS-Cart version, edition, PHP version and the add-on version (1.0.0).