For the complete documentation index, see llms.txt. This page is also available as Markdown.

Setting up Stripe payments

This guide covers connecting a Stripe account to your Pixfizz storefront, including the webhook Stripe uses to tell Pixfizz whether a payment succeeded or failed. It applies to both Full Pixfizz (custom eCommerce) and Shopper storefronts.


Video walkthrough

Watch the full setup from start to finish:


Overview

Connecting Stripe involves filling in a small set of fields in the Pixfizz superadmin, and creating a webhook inside your Stripe account so payment results are reported back to your store.

The fields you will fill in on the Pixfizz side are:

  • Publishable key

  • Secret key

  • Webhook signing secret

  • Success URL

  • Cancel URL

The webhook signing secret is the one that takes a little more effort. The rest are quick copy-and-paste.

If you do not have access to the Pixfizz superadmin, collect the keys and the signing secret described below and send them to your Pixfizz account manager, who will enter them for you.


Where to enter your Stripe details in Pixfizz

  1. From your Pixfizz admin, go to the superadmin.

  2. Find the site you want to set up. Most accounts only have one or two sites. If you have multiple sites, select the specific site you want to connect Stripe to. Each site can use a different payment gateway or a different Stripe account.

  3. Scroll down to the Payment Gateway section and select Stripe.

  4. Keep this screen open. You will paste the keys, signing secret, and URLs into it in the steps below.


Step 1: Get your API keys from Stripe

  1. Log in to your Stripe account.

  2. Go to the Developers tab (bottom left), then open API keys.

  3. Use the standard keys. Do not use restricted keys.

  4. Copy the Publishable key (it starts with pk_live_) and paste it into the matching field in Pixfizz.

  5. For the Secret key, you must create a new one. Existing secret keys cannot be revealed again, so click to create a new secret key.

    • Choose full access.

    • Complete any identity verification Stripe asks for (for example Touch ID or two-factor).

    • Copy the new secret key immediately. It starts with sk_live_ in live mode and is only shown once.

  6. Paste the secret key into the matching field in Pixfizz.


Step 2: Set the Success and Cancel URLs

These tell the customer's browser where to go after a payment attempt. You can use relative paths or full URLs.

  • Success URL: /site/payment_success

  • Cancel URL: /site/payment_failed

When to use full URLs

If you plan to use the QR code payment link (covered in Step 4), you must enter full URLs instead of relative paths, for example:

  • https://yourmaindomain.com/site/payment_success

  • https://yourmaindomain.com/site/payment_failed

Use your main, canonical domain — the version that does not redirect. If your site loads on www, use the www version; if it loads without www, use that. This avoids an extra redirect during payment.


Step 3: Create the webhook and copy the signing secret

The webhook is what Stripe uses to tell Pixfizz whether a payment was successful, failed, or cancelled.

Stripe changes this interface from time to time, so the exact button names may differ slightly from what you see here.

  1. In Stripe, go to Developers > Webhooks.

  2. Click Add destination (older versions show Add endpoint).

  3. Select the events Pixfizz needs to listen for. There are six in total — three under checkout and three under payment intent:

    • checkout.session.completed

    • checkout.session.async_payment_succeeded

    • checkout.session.async_payment_failed

    • payment_intent.canceled

    • payment_intent.succeeded

    • payment_intent.payment_failed

  4. Click Continue.

  5. Give the destination a name, such as Pixfizz Store.

  6. Enter the endpoint URL:

    • https://<yoursubdomain>.pixfizz.com/cart/stripe_callback

    • It is safest to use your Pixfizz subdomain here, because that address is always available. You can use your main domain instead, but the subdomain avoids problems if your custom domain changes.

  7. Create the destination.

  8. Locate the Signing secret for the new destination, reveal it, and copy it. It starts with whsec_.

  9. Paste the signing secret into the matching field in Pixfizz.

Note for older Stripe layouts: the previous version asks for the endpoint URL first and the events second. The values to enter are the same.


Step 4: Save and connect

Once all of the fields (publishable key, secret key, signing secret, success URL, cancel URL) are filled in, click Save. This connects Stripe as the main payment gateway for the site.


Step 5 (Shopper only): Select Stripe in Storefront Settings

If your storefront is Shopper (the managed storefront from Pixfizz), there is one extra step.

  1. Open the Custom Admin, also called the Site Setup Dashboard.

    • When signed in as an admin, this button is usually under the small Pixfizz logo in the footer.

    • If the footer has been customized, the button may be hidden or removed.

  2. Go to Storefront Settings.

  3. At the bottom right, select Stripe as the payment provider.

  4. If you want the QR code payment link, enable it here.

  • It is available with Stripe or Square.

  • It shows a QR code at checkout that the customer can scan with their phone to open a payment page and pay there.

  • It requires full (absolute) URLs in the Success and Cancel URL fields (see Step 2).


Configuring which payment methods customers see

Which payment methods appear at checkout — cards, wallets, and so on — is controlled inside Stripe, not in Pixfizz.

  • In Stripe, go to Payments > Payment Methods.

  • Enable or disable methods as needed. You can keep it as simple as cards only, or turn on others.

  • Each method you enable may add its own form to the checkout page.

When the QR code payment link is enabled, the Stripe payment form is embedded directly on the Pixfizz checkout page.


Field summary

Field in Pixfizz
Where to get it
Format

Publishable key

Stripe > Developers > API keys

starts with pk_live_

Secret key

Stripe > Developers > API keys (create new)

starts with sk_live_

Webhook signing secret

Stripe > Developers > Webhooks (per destination)

starts with whsec_

Success URL

You set this

/site/payment_success or full URL

Cancel URL

You set this

/site/payment_failed or full URL


  • Payment Gateways (parent section)

  • Setting up Square payments (if applicable)

Last updated