This article covers the following:
Enabling E-Commerce
1. In your AG Website settings. Navigate to the E-Commerce tab.
2. Tick Enable Cart.
3. Click Save.
Changing the cart icon
Now the E-Commerce has been enabled, a cart icon will be displayed in the top right of the website. You can change this icon from the following section:
Default cart icon:
Customizing checkout message
The checkout message is a flexible space to share key information at the point of purchase.
It can be used to set expectations, outline next steps, request additional details, or clarify anything not covered elsewhere. This helps keep buyers informed and reduces the need for follow-up.
Overall, it’s a simple way to guide the customer and create a smoother purchasing experience.
You can also add up to three Checkout info cards, to further tailor your checkout experience:
Checkout Tax
Art Galleria uses Stripe Tax to calculate tax during the checkout process.
Stripe Tax is integrated directly into the website checkout, so your customers complete the entire purchase through your Art Galleria Website as normal.
When a customer proceeds to checkout:
The customer enters their purchase and checkout details on your website.
Art Galleria passes the relevant checkout information to Stripe Tax.
Stripe Tax calculates the applicable tax for the transaction.
The calculated tax is returned to the Art Galleria checkout and included in the customer’s order total.
The customer sees the final amount, including tax, before completing payment.
Once payment is successful, the tax amount charged by Stripe is recorded on the Art Galleria invoice.
The customer does not need to leave your website, visit Stripe separately, or calculate any tax themselves. Stripe Tax works behind the scenes as part of the Art Galleria checkout.
If Stripe Tax cannot successfully confirm the tax calculation, the checkout will stop and payment will not be taken.
Before You Enable Stripe Tax
Before Stripe Tax can be enabled in Art Galleria, you must make sure the required tax settings are already configured.
1. Turn on Sales Taxes in Art Galleria
Sales taxes must be enabled in your Art Galleria account.
Your default tax option must also be set to either:
Inclusive
Exclusive
If your default tax option is set to No tax, Stripe Tax cannot be enabled.
2. Set Up Stripe Tax in Stripe
Stripe Tax must be fully configured and active within your connected Stripe account.
This includes setting a default tax code in Stripe.
Your Stripe account must also be active and able to accept payments.
If Stripe Tax is not fully set up in Stripe, Art Galleria will not allow automatic tax to be enabled.
3. Enable Stripe Tax in Art Galleria
Go to Settings → Payment Services in Art Galleria.
Find the Stripe account you want to use, and open the Settings for that Stripe account.
Tick the Stipe Tax Enabled box.
Save your changes.
Stripe Tax is enabled separately for each connected Stripe account.
If you have more than one Stripe account connected to Art Galleria, turning Stripe Tax on for one account will not automatically enable it for the others.
What Happens After You Turn It On?
Once Stripe Tax is enabled, Art Galleria will check that your tax settings are still valid each time a customer checks out.
This means:
Sales taxes must still be turned on in Art Galleria.
Your default tax option must still be Inclusive or Exclusive.
Stripe Tax must still be active and correctly configured in Stripe.
If any of these settings are changed later, checkout may stop working until they are corrected. Art Galleria will not simply continue the checkout without charging tax.
Inclusive and Exclusive Tax
Your Art Galleria default tax option determines how tax is treated on purchases.
Inclusive
The artwork price already includes tax.
For example, if an artwork is listed at $1,100 including tax, the customer still sees $1,100 as the artwork price, with the tax portion calculated within that amount.
Exclusive
Tax is added on top of the artwork price during checkout.
For example, if an artwork is listed at $1,000 before tax, Stripe Tax calculates the applicable tax and adds it to the final checkout total.
Card Surcharges
Any card surcharge added during checkout is not taxed.
Stripe Tax only calculates tax on the applicable artwork and shipping amounts.
What Happens to the Art Galleria Invoice?
After the customer successfully completes payment, Art Galleria creates the invoice using the tax amount that Stripe actually charged.
The invoice will therefore reflect the final checkout transaction, including:
Artwork amount
Shipping
Tax
Card surcharge, if applicable
If you later change your shipping settings or tax settings, this will not change invoices that have already been created.
Important
Art Galleria does not determine your tax obligations or choose the tax rate to charge.
The actual tax calculation is performed by Stripe Tax, using your Stripe Tax configuration and the information available during checkout.
You are responsible for making sure your Stripe Tax account and Art Galleria tax settings are configured appropriately for your business.
Checkout shipping (Shipping profiles)
Art Galleria uses Shipping Profiles to offer shipping options during Website checkout. When a buyer checks out, they enter their country and state. Art Galleria then shows the shipping options that match their destination and order.
The buyer selects one option before payment. That shipping amount is then sent to Stripe and charged as part of the transaction. Stripe does not calculate or recalculate the shipping rate.
Before You Begin
For shipping rates to appear on your Website checkout, both of the following must be set up:
Shipping must be enabled on your connected Stripe account.
A Shipping Profile must be assigned to the Portfolio used by your Website.
Your Website does not have its own Shipping Profile. It uses the profile assigned to its Portfolio.
Create a Shipping Profile
1. Navigate to Settings > Shipping Profiles > New profile
2. Set the:
Profile name
Currency
Active status
The profile currency must match the currency of the purchase.
3. Click Options > + Add option, then add the shipping options you want to offer.
Each option can include:
Name
Country
State
Rate (Shipping cost)
Optional:
Cart value & item quantity limits
Tax treatment
A rate of 0 can be used for free shipping.
Assign the Profile to Your Website Portfolio
Go to your Website Portfolios list and assign the Shipping Profile to the Portfolio used by your Website. Your Website will automatically use the profile assigned to that Portfolio.
Enable Shipping on Stripe
1. Navigate to Settings > Payment Services.
2. Click Settings on your Stripe account.
3. Tick Stripe Shipping Enabled
Your Stripe account must be connected and able to accept payments.
How Shipping Works at Checkout
When a buyer selects shipping, Art Galleria checks the Shipping Profile against:
Country
State
Cart value
Number of items
Only matching active options are shown. The buyer selects a shipping option, completes their address, and proceeds to payment.
If no option matches, the buyer will see:
Shipping is unavailable for this destination.
No payment will be taken.
Shipping and Tax
Each shipping option can be set to:
No tax
Inclusive
Exclusive
This setting is used only when Stripe Tax is enabled.
If Stripe Tax is off, the shipping amount is charged exactly as entered.
FAQ
Why can’t I turn Stripe Tax on?
Why can’t I turn Stripe Tax on?
Before Stripe Tax can be enabled, check that:
Sales taxes are enabled in Art Galleria.
Your default tax option is set to Inclusive or Exclusive.
Stripe Tax is fully active in Stripe.
A default tax code has been configured in Stripe.
Your Stripe account is able to accept payments.
What does “Stripe Tax is not ready for this account” mean?
What does “Stripe Tax is not ready for this account” mean?
This means Stripe Tax has not been fully configured on your connected Stripe account. Log in to Stripe and confirm that:
Stripe Tax is active.
A default tax code has been set.
Once this has been completed, return to Art Galleria and try enabling Stripe Tax again.
What does “Stripe Tax cannot be charged because sales taxes are turned off” mean?
What does “Stripe Tax cannot be charged because sales taxes are turned off” mean?
This means sales taxes are currently disabled in your Art Galleria account.
Turn on sales taxes in Art Galleria, then try again.
What does “Stripe Tax cannot be charged because the default tax option is not set” mean?
What does “Stripe Tax cannot be charged because the default tax option is not set” mean?
Your default tax option in Art Galleria is either blank or set to No tax.
Change the default tax option to either Inclusive or Exclusive before using Stripe Tax.
Why has checkout stopped working when Stripe Tax was working previously?
Why has checkout stopped working when Stripe Tax was working previously?
Art Galleria checks your tax settings each time a customer checks out.
Checkout may stop working if someone has since:
Turned off sales taxes in Art Galleria.
Changed the default tax option to No tax.
Disabled or changed Stripe Tax within Stripe.
Changed the connected Stripe account so that it can no longer accept payments.
The Stripe Tax setting may still appear enabled in Art Galleria, but the required settings must remain valid for checkout to continue.
What happens if Stripe cannot calculate the tax?
What happens if Stripe cannot calculate the tax?
If Stripe Tax cannot confirm the tax calculation, checkout will stop and payment will not be taken. The customer can try the checkout again later.
Art Galleria will not process the payment without a confirmed tax calculation.
Does Stripe Tax apply to shipping?
Does Stripe Tax apply to shipping?
Yes, if the selected shipping option is configured to be taxed.
Each shipping option can have its own tax treatment:
Inclusive
Exclusive
No tax
If a shipping option is set to No tax, no tax will be charged on that shipping amount, even if the artwork itself is taxed.
Is the card surcharge taxed?
Is the card surcharge taxed?
No. Card surcharges are not taxed.
Does Stripe Tax work on manually created invoices?
Does Stripe Tax work on manually created invoices?
No, Stripe Tax currently applies only to purchases made through:
Art Galleria Websites
Private Rooms
Portfolio
It does not currently apply to manually created invoices, ArtPass purchases, or Artist Portal submission fees.
What should I do if the Art Galleria invoice does not match the Stripe payment?
What should I do if the Art Galleria invoice does not match the Stripe payment?
Compare the final payment in Stripe with the Art Galleria invoice. If the totals do not match, contact Art Galleria Support and provide the Stripe payment reference so the transaction can be investigated.
Do not charge the customer again unless instructed to do so.
I turned shipping on, but no rates are showing.
I turned shipping on, but no rates are showing.
Check that:
A Shipping Profile is assigned to your Website Portfolio.
The profile and shipping option are active.
The profile currency matches the artwork currency.
The buyer's country, state, cart value, and item count match an option.
Shipping is enabled under Payment Services.
Does Stripe calculate the shipping rate?
Does Stripe calculate the shipping rate?
No, Art Galleria determines the available shipping options and the buyer selects one during checkout. Stripe simply charges the selected amount.
Can I offer free shipping?
Can I offer free shipping?
Yes, create a shipping option with an amount of 0.
Can I use different rates for different locations?
Can I use different rates for different locations?
Yes, you can create shipping options for:
A specific state
A whole country
All countries
Can I use live courier rates?
Can I use live courier rates?
No, shipping Profiles use fixed rates entered by you.
There is currently no live courier, postcode, weight, or carrier-rate lookup.
Can I use a different Shipping Profile for each Website?
Can I use a different Shipping Profile for each Website?
Shipping Profiles are assigned to Website Portfolios.
If two Websites use the same Portfolio, they will use the same Shipping Profile.
Can customers choose to pick up from the gallery?
Can customers choose to pick up from the gallery?
Yes, pickup is already built into the Website checkout and does not need to be configured separately. Where the checkout offers Ship or Pickup, the customer can select Pickup instead of shipping.
If Pickup is selected:
No Shipping Profile rate is applied.
No shipping charge is added.
The customer can continue through checkout without selecting a shipping option.
You do not need to create a separate $0 shipping option for gallery pickup.
Where can I keep track of my website orders?
Where can I keep track of my website orders?
Once an order is placed through the website, it will automatically:
Create an invoice in Art Galleria
Create the contact (if they don't already exist)
Create an Order in Art Galleria, which can be viewed and tracked from the dedicated Sales > Orders tab.
Will I get a notification when someone makes an order?
Will I get a notification when someone makes an order?
Yes, you will receive a purchase notification directly to your email.
When someone buys an artwork, will it automatically be marked as sold?
When someone buys an artwork, will it automatically be marked as sold?
Yes - the artwork quantity will be automatically adjusted / the status will be changed. If you have multiple quantities of an artwork, the quantity purchased will simply be subtracted from the overall amount available.
What payment providers are available to use through the checkout?
What payment providers are available to use through the checkout?
Stripe is required in order to enable E-Commerce on the website, and is currently the only supported payment provider.