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.
The Bolt Checkout Button initiates the shopper’s checkout experience and can be placed across multiple pages on your store.
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
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.
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.
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 functionality to their checkout experience for added security against bot attacks (e.g., a bot quickly checking out with many different credit cards).
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 user experience to your shoppers across retailers within Bolt’s network. Bolt SSO upgrades your existing shopper accounts to Bolt Accounts, giving your customers a fast, passwordless login and one click checkout anywhere in the Bolt Network. It’s still your brand, just powered by the Bolt Network.
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.