Merchant Setup Options

What Merchant Setup offers a merchant is yours to decide: which processors they may choose from, whether they see Shuttle's terms or your own, and which parts of the screen they get at all.

Options are set in one of two places.

Set On The Application

In the Developer Portal, open your application, choose the Developer tab and then Configure Onboarding. What you set there applies to every Merchant Setup session that application creates. Sandbox and Live are configured independently, so a change can be proved before it reaches production.

Find Configure Onboarding
OptionWhat it does
Merchant Setup Terms and ConditionsDeselect to stop Shuttle presenting its own terms. Shuttle's terms cover Shuttle's requirements and any the payment processors impose, so if you turn this off you take on the legal obligation of carrying equivalent terms in your own. See Accepting the terms.
Hide MarketplaceRemoves the link to Shuttle's merchant portal. Leave it enabled where a revenue share agreement is in place.
Hide Customise CheckoutRemoves the section where a merchant routes payment methods to processors and sets amount rules. Use it where you would rather make those choices on their behalf.
Hide Preview CheckoutRemoves the preview of the checkout a merchant's configuration produces.
Customise Onboarding

Set On The Deep Link

Pass these in the context of a gateway-setup deep link. They apply to that session only, which lets you vary the experience by merchant.

OptionWhat it does
processorRestricts the whole component to one processor, which is app store mode: the merchant connects and configures that one and is offered no choice. See Merchant Setup.
processor_filterNarrows the list to the processors you name, as a CSV of processor ids, e.g. STRIPE,PAYPALC. In general prefer configuring the available processors on your application.
countryThe merchant's country, which decides the processors offered. Taken from the IP address you pass at deep link creation unless you set this, as a two-letter ISO code, e.g. US or GB.
themeFonts, colours, spacing and border radius, so the component sits inside your own design. See Styling.

A Choice You Make Once

processor is not only a display option. Passing it puts the instance into app store mode, with one processor per instance; leaving it off gives the merchant the full-stack experience where several processors can be connected and composed into one checkout.

You can move an app store instance to full stack later by dropping the parameter. You cannot move it back once a second processor has been added, even if that one has since been archived.

What The Merchant Sees

Every screen is documented, one page per screen: Merchant Setup user guide. What each control is allowed to do, and what it refuses, is in Business Rules.


Did this page help you?