1. Customer Submits Retrieval Request A retrieval request is a demand for additional information, which may precede a dispute. A retrieval request occurs when a shopper asks their issuing bank for detailed information about a specific transaction on their account. The shopper usually makes a retrieval request because they don’t understand or recognize the charge, or because they suspect fraud on their account. The shopper’s issuing bank will then request proof of what occurred in the transaction.
Bolt understands the importance of protecting your shopper’s information while providing a smooth onboarding experience. Because of this, all account upgrades are handled directly by our expert internal team to ensure: Account information is exported and migrated securely All login workflows are properly accounted for, upgraded, and tested The brand experience of SSO accounts aligns with your store SSO Commerce Onboarding Steps Onboarding your store and shoppers is easy.
The Bolt Checkout Button initiates the shopper’s checkout experience and can be placed across multiple pages on your store.
Accounts Onboarding Questions What happens to an existing shopper’s store account? Shoppers are prompted to link their original store account to a Bolt account upon their next login after SSO Commerce is enabled. How are Bolt accounts linked to a store account? If a shopper has an existing Bolt account and an account associated to your store, they are prompted to link the accounts upon their next login to Bolt.
Use this guide to set up a basic Bolt Checkout flow on your website.
/v1/merchant/orders.order.shipping_and_tax request from Bolt.discount.code.applyrequest from Boltorder.create request from Bolt
Enable your shoppers to take advantage of their Apple Pay account during checkout. Unsure which alternative payment methods to set up? See all supported alternative payment methods. Requirements Domain Verification Apple requires that your website use HTTPS, with a valid SSL certificate, TLS 1.2 support, and a unique IP with no redirects. Merchants must re-verify their domain with a new certificate when changing domains. Reach out to Bolt to get your domains re-verifed.
Keeping your Bolt Checkout version up to date is important to take advantage of new features and enhancements. How to Check Bolt Versions Checkout Versions The Bolt Checkout displays the Bolt Version. Navigate to your storefront. Launch Bolt Checkout. Look in the lower right corner for the build number. Plugin Versions Bolt uses reports the plugin version to console.log wherever Bolt Checkout is loaded. In Chrome, open Developer tools and navigate anywhere Bolt is loaded, for example, the cart page.
Previously, you learned how to integrate with Bolt Checkout. Now let’s enhance that integration by configuring analytics. Bolt supports pixel tracking by sending Shopper-triggered events to a merchant’s Google and Facebook analytics platforms. You must be an admin user in your Merchant Account to update tracking IDs.
Bolt’s tokenizer is a public package on NPM and can be used to implement custom back-office integrations, such as direct payment processing, when also paired with the authorization endpoint.
Chargebacks with Stripe have some unique factors due to the requirements of our integration through Stripe connect. For details on disputes in general, Bolt’s Dispute Process.
As a Merchant partnered with Bolt, you can customize your checkout experience in a variety of ways. This allows you to keep your experience on-brand as well as achieve more control over engagement with your shoppers.
An abandoned cart occurs when a shopper has a non-empty cart, opens checkout, fills in at least their email, but does not complete the checkout process. Merchants can remind shopper’s of their full cart using an automated email notification to help them complete their intended purchase. Read how to enable this feature.
Bolt Checkout includes address verification to ensure shoppers enter a correct shipping address. When a shopper enters an unrecognized shipping address, Bolt Checkout highlights the shipping address field and prompts the shopper to verify the address.
Merchants can add several alternative payment methods (APMs) to the Bolt Checkout experience. Payment options display during the Payment step for a shopper. See our APM enablement guides for setup instructions.
Merchants can create an express-checkout experience for their shoppers by enabling the Always Available Checkout Button. The Always Available Checkout Button displays when an item is initially added to a shopping cart and floats with the shopper’s movement on and across all supported pages. Read how to enable this feature
Bolt Accounts enable merchants to offer enhanced features that extend beyond Bolt’s checkout experience, such as: Order Tracking, Reordering, and SSO Commerce.
You can display Bolt’s own confirmation page instead of your cart’s default when a shopper checks out. This allows merchants to benefit from a modern, well-featured confirmation page without any extra setup or plugins.
Card testing is a fraudulent practice where stolen card information is used in an attempt to make unauthorized purchases. This practice is also known as: Account testing Carding Card checking Although fraudulent activity can’t be fully prevented, it can be detected and mitigated. At Bolt, we’re constantly improving our tools and products to ensure the occurrence of fraud is minimized for your business as well as your customers.
Merchants on custom cart platforms can group similar items in Bolt checkout using Cart Groups. One common use case is to group items in the shopper’s cart by expected shipping or delivery dates. Read how to enable Cart Groups.
When shoppers reach out for help creating an order—whether by phone, email, or other support channels—you can now make that process more safe, secure and streamlined with Bolt’s Checkout via Link. You build the order, then send a simple link to your shopper. Shoppers are directed to the Bolt checkout and prompted to enter their payment information and complete the order. Read how to enable Checkout via Link.
Custom Checkboxes enable merchants to add custom opt-ins to the shopper’s checkout experience. Custom Checkboxes dynamically allow you to enhance relationships with your shoppers (such as newsletter opt-ins), as well as maintain compliance for regulatory requirements when selling certain goods.
Custom Dropdowns enable merchants to add dropdowns to the Bolt checkout modal. Dropdowns are great for survey-related questions (e.g., “where did you hear about us?") and gathering data.
As a merchant, you can add custom notices to your shopper’s checkout experience. Custom notices allow merchants to keep shoppers informed of important information and can be displayed using dynamic rules.
Discount Codes enable merchants to run special deals their shoppers can take advantage of during certain seasons, events, or sign-up promotions. Read how to enable Discount Codes.
Enable your shoppers to pay using their Amazon Pay account during checkout. Unsure which alternative payment methods to set up? See all supported alternative payment methods. Prerequisites Merchants must have a pre-existing relationship with Amazon Pay before setting up this payment method. 1. Link Amazon Pay to Bolt Log in to the Bolt Merchant Dashboard. Navigate to Settings. Scroll to Alternative Payment Settings > Amazon Pay. Select Amazon Pay > Continue.
Enable Checkout via Link How to set up Checkout via Link for Shoppers. Enable the Always Available Checkout Button How to set up the Always Available Checkout Button. Enable the Product Page Checkout Button How to set up the Product Page Checkout Button. Enable the Standard Checkout Button Learn how to add scripts to your storefront and call Bolt Checkout.
Enable your shoppers to pay using Klarna’s “Pay in 4” installments offering during checkout. Unsure which alternative payment methods to set up? See all supported alternative payment methods. Prerequisites Merchants must have a pre-existing relationship with Klarna before setting up this payment method. Reach out to your Bolt Customer Success Manager before Enabling Klarna. How to Add Klarna to Bolt Checkout 1. Link Klarna to Bolt Log in to the Bolt Merchant Dashboard.
The Bolt Checkout Button initiates the shopper’s checkout experience and can be placed across multiple pages on your store.
Every order which passes through Bolt Checkout undergoes Bolt’s Fraud Review process; there are three major steps in the Fraud Review process: the shopper pays, the order is checked by our fraud engine, and then the order is analyzed by Bolt’s Fraud Team.
In-Store Pickup enables merchants with brick-and-mortar stores to offer an alternative to shipping for their shoppers. Shoppers can choose from a list of stores nearest them instead of having to pay (and wait) for delivery. Read how to enable this feature.
Language localization enables shoppers to view checkout instructions and cart totals in their local language. This feature is disabled by default.
Merchants can use location-based shipping restrictions in their Bolt Checkout. These aid merchants who cannot ship their products to specific states or countries. Read how to enable Location-Based Shipping Restrictions.
A micro-authorization is a small, temporary charge that Bolt authorizes on a shopper’s card. The shopper then provides the value of the charge to Bolt to prove that that they have access to their account, enabling higher order approval rates for your business.
Bolt provides multi-currency (non-U.S. Dollar(USD)) support. The support for multi-currency varies depending upon the ecommerce platform and payment processor being used. Bolt uses WorldPay(Vantiv) for the majority of its payment processing. In addition, on a limited basis, Bolt uses Stripe for some merchants.
Merchants add an order notes field within Bolt Checkout. This field appears under the delivery options and allows a maximum of 520 characters. By default the field is called Order notes (optional), however, both the caption and the field are customizable.
As a merchant, you can provide shoppers with SMS updates that point to your store’s branded order tracking page. Order tracking pages add a layer of visibility for the consumer and reduce your number of support tickets related to orders en-route.
Bolt provides a setting to disable shipment to P.O. boxes on the Bolt Merchant Dashboard via Checkout Settings.
Pre-authorization is a redesigned sequence that changes how Bolt works with cart and card authorizations. When a shopper select the Pay button in Bolt Checkout, there are two events which must happen for a successful order to occur.
Product Add-ons are a great way for merchants to add convenience and enhance the shopping experience. Offering complementary or add-on products such as gift boxes, insurance, screen protectors, or batteries can ensure you have everything you need for your purchase. Read how to enable this feature.
The Product Page Checkout button adds an express-checkout option to your product pages that forwards shoppers directly to Bolt Checkout to complete their purchase. Read how to enable the Product Page Checkout Button.
Merchants can configure the Bolt Checkout modal to display controls for increasing or decreasing the quantity of products in a shopper’s cart. Read how to enable Product Quantity.
Merchants can add reCAPTCHA (powered by Google) to their checkout experience for added security against bot attacks (e.g., a bot quickly checking out with many different credit cards). Bolt’s reCAPTCHA adds no friction to the shopper’s checkout experience.
Once a refund has settled, it can take up to 7 days for the refund to show up on the customer’s statements. The speed at which the refund appears on the statement is fully dependent on the customer’s card issuer.
Checkout notifications are important for keeping a shopper informed about their order status, abandoned carts, and any additional actions they may need to take. Read how to enable Checkout Notifications.
Deliver a secure, logged-in experience to your customers that results in increased account registrations for you and reduced friction for your shoppers. SSO Commerce unifies logins for shoppers by connecting your store accounts with Bolt Accounts. This gives your shoppers access to everything related to your brand—like past order history and loyalty programs—and a one click checkout experience across all sites in the Bolt Network. It’s still your brand, just powered by Bolt.
Merchants can set up subscriptions purchasable through Bolt Checkout. In order to deploy Bolt with subscription functionality merchants must provide a subscription plan to Bolt Support.
You can use the following card numbers to simulate scenarios in a sandbox. The type of test cards used vary depending on the processor or gateway set up with your merchant account.
| Scenario | Number | Behavior |
|---|---|---|
| Reviewed and approved by Bolt | 4111 1111 1111 1111 | |
| Reviewed and irreversibly rejected by Bolt | 4457 0101 4000 0141 | Shopper reaches order confirmation but is notified via email that there was an issue completing the order. |
| Reviewed and reversibly rejected by Bolt | 4457 0102 0000 0247 | |
| Bolt rejection before authorization | 4100 2003 1000 0002 | Shopper receivesan error and does not proceed to order confirmation. |
| Place in review | 4457 0002 0000 0008 | |
| Processor rejection | 3743 133042 11118 | Shopper receivesan error and does not proceed to order confirmation. |
You can use the following order totals to simulate order scenarios in your Bolt sandbox. Need to set up your sandbox? refer to our Environment Details reference article for all necessary API keys and URLs. Bolt Order Amounts Outcome Order Total Reviewed & Approved $8,017.01 Irreversibly Rejected $8,017.02 Reversibly Rejected $8,017.03 Declined $8,017.04 Auto-Approved (No Review) $8,017.
The minimum transaction amount allowed with Bolt is $0.50. The fees could result in a negative order amount being applied to your balance, so we block these transactions to prevent our merchants from losing money on an order.
Micro-authorizations are temporary, small transactions (typically less than 1.00 USD) that merchants use to verify a shopper’s identity after placing an order. Once you receive the micro-authorization, you can submit the amount (e.g., 0.37) to validate your ownership of the credit card. The charge is removed from your account typically within 48 hours.