> ## Documentation Index
> Fetch the complete documentation index at: https://funnelfox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Solidgate

> Integrate Solidgate as your payment provider in FunnelFox. Configure checkout, subscriptions, and payment processing for web funnels.

Solidgate is a payment integration that provides optimized
payment processing for digital goods with high approval rates and
comprehensive fraud prevention for gaming, digital content, and subscription services.

## Key features

FunnelFox supports the following payment methods and transaction types with Solidgate:

| Transaction type               | Cards | Apple Pay | Google Pay | PayPal |
| ------------------------------ | :---: | :-------: | :--------: | :----: |
| **Subscriptions**              |       |           |            |        |
| Subscriptions                  |   ✅   |     ✅     |      ✅     |    ✅   |
| Free & paid trials             |   ✅   |     ✅     |      ✅     |    ✅   |
| **Upsells**                    |       |           |            |        |
| One-time products              |   ✅   |     ✅     |      ✅     |    ✅   |
| Subscription upsells (2nd sub) |   ✅   |     ✅     |      ✅     |    ✅   |
| Subscription upsells (upgrade) |   ❌   |     ❌     |      ❌     |    ❌   |
| **Offers**                     |       |           |            |        |
| Intro offers                   |   ❌   |     ❌     |      ❌     |    ❌   |
| Promo codes (Coupons)          |   ❌   |     ❌     |      ❌     |    ❌   |

Learn more about [configuring each transaction type](/docs/integrations/payments/solidgate#subscription-configuration) in your funnel.

### Additional features

* **Cancellation funnels**: Full support for [cancellation flows](/docs/dashboard/funnels#cancellation-funnels) with options to offer discounted subscriptions, gifts, or pauses instead of losing customers completely.
* **Failed payment recovery**: Automatic support for [Solidgate retries](https://docs.solidgate.com/billing/manage-subscription/recover-revenue/) to reduce revenue loss from failed payments.
* **Wallet button**: [One-click payment button](/docs/elements/wallet-button) for Apple Pay and Google Pay. Includes a fallback option when Apple Pay or Google Pay isn't available.

## Setup

You need two active and verified channels (Sandbox and Live) available in [Developers > Channels](https://hub.solidgate.com/dev/channel) in your Solidgate Dashboard to integrate with FunnelFox.

Keep both FunnelFox and Solidgate dashboards open during setup—you'll switch between them several times.

### 1. API keys

**Public key**

1. Go to [Developers > Channels](https://hub.solidgate.com/dev/channel) in Solidgate and open the Sandbox channel.

2. Copy the **Public key** under **API keys**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/6YHRxIZ7Mqh2GRqE/assets/solidgate-public.png?fit=max&auto=format&n=6YHRxIZ7Mqh2GRqE&q=85&s=8f09e59ee18ce20143ac195f9acec00e" width="1920" height="879" data-path="assets/solidgate-public.png" />
</Frame>

3. Go to [Integrations > Solidgate](https://app.funnelfox.com/integrations/solidgate) in FunnelFox.

4. Paste the Public key into the **API Key Public** field under **Sandbox**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/CisFhxq481fF6x_l/assets/solidgate-public-insert.png?fit=max&auto=format&n=CisFhxq481fF6x_l&q=85&s=9a9c453fea7c5e022fe29ace2c38f56a" width="1920" height="879" data-path="assets/solidgate-public-insert.png" />
</Frame>

<Info>Don't close your Solidgate integration settings in FunnelFox and proceed with the next section.</Info>

**Secret key**

1. Go back to the Sandbox channel in Solidgate.

2. Copy the **Secret key** under **API keys**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/6YHRxIZ7Mqh2GRqE/assets/solidgate-secret.png?fit=max&auto=format&n=6YHRxIZ7Mqh2GRqE&q=85&s=c6a8db3e9b7d31cd5a5cdb1e04d1a148" width="1920" height="879" data-path="assets/solidgate-secret.png" />
</Frame>

3. Go back to your Solidgate settings in FunnelFox.

4. Paste the Secret key into the **API Key Secret** field under **Sandbox**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/CisFhxq481fF6x_l/assets/solidgate-secret-insert.png?fit=max&auto=format&n=CisFhxq481fF6x_l&q=85&s=e3bfd36f9993ed46af9279c16b0cab21" width="1920" height="879" data-path="assets/solidgate-secret-insert.png" />
</Frame>

### 2. Webhook keys

**Public key**

1. Go back to the Sandbox channel in Solidgate.

2. Copy the **Public key** under **Webhook keys**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/UuRvJ1DcBE-uFa6t/assets/solidgate-webhook-public.png?fit=max&auto=format&n=UuRvJ1DcBE-uFa6t&q=85&s=c90bf129426a9d0c53387ce3b30f59a2" width="1860" height="820" data-path="assets/solidgate-webhook-public.png" />
</Frame>

3. Go back to your Solidgate settings in FunnelFox.

4. Paste the Public key into the **Webhook Public** field under **Sandbox**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/CisFhxq481fF6x_l/assets/solidgate-paste-webhook-public.png?fit=max&auto=format&n=CisFhxq481fF6x_l&q=85&s=708f03092e1da2d8ced7626574c11726" width="1920" height="879" data-path="assets/solidgate-paste-webhook-public.png" />
</Frame>

**Secret key**

1. Go back to the Sandbox channel in Solidgate.

2. Copy the **Secret key** under **Webhook keys**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/UuRvJ1DcBE-uFa6t/assets/solidgate-webhook-secret.png?fit=max&auto=format&n=UuRvJ1DcBE-uFa6t&q=85&s=0f6e31b6dc3f12834561e6c711ad32ae" width="1860" height="820" data-path="assets/solidgate-webhook-secret.png" />
</Frame>

3. Go back to your Solidgate settings in FunnelFox.

4. Paste the Public key into the **Webhook Secret** field under **Sandbox**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/CisFhxq481fF6x_l/assets/solidgate-paste-webhook-secret.png?fit=max&auto=format&n=CisFhxq481fF6x_l&q=85&s=7c6e3d4bb77afe73c19e3e0f730e07ff" width="1920" height="879" data-path="assets/solidgate-paste-webhook-secret.png" />
</Frame>

### 3. Live channel configuration

1. Open your Live channel in Solidgate and repeat the setup process above.

2. Click **Save changes** on the Solidgate settings page in FunnelFox.

<Check>Your Solidgate integration is now active! Remember to republish your funnels to apply the changes.</Check>

## Subscription configuration

FunnelFox automatically creates webhooks in your Solidgate account and syncs your products after setup.

Products created in Solidgate become available in the **Element** tab of your [Checkout element](/docs/elements/checkout#subscription-configuration).

Configure Solidgate products in your funnels:

* [Free trial](/docs/elements/checkout#free-trial)
* [Paid trial](/docs/elements/checkout#paid-trial)
* [Upsell](/docs/elements/checkout#upsell)

<Frame>
  <img src="https://mintcdn.com/funnelfox/6YHRxIZ7Mqh2GRqE/assets/solidgate-products.png?fit=max&auto=format&n=6YHRxIZ7Mqh2GRqE&q=85&s=264c9b5168a9e5de90fe16a02468aeac" width="1128" height="854" data-path="assets/solidgate-products.png" />
</Frame>

<Tip>
  Create one Solidgate product per currency and select it per funnel locale
  to boost conversion. Visitors check out in the currency they expect. Learn
  about [pricing localization](/docs/editor/pricing-localization).
</Tip>

## Digital wallets

FunnelFox supports Apple Pay and Google Pay with Solidgate for faster checkout. Apple Pay requires domain verification, while Google Pay works by default.

Once your setup is complete, add a
[Wallet button](/docs/elements/wallet-button) to your funnels.

### Apple Pay

Apple Pay for Solidgate requires domain verification before you can use it.

To enable Apple Pay:

1. Go to [Developers > Apple Pay Domains](https://hub.solidgate.com/dev/apple-pay-domain) in Solidgate.

2. Click **+ Add new domain** at the top right.

<Frame>
  <img src="https://mintcdn.com/funnelfox/jUS1VyQCpYewnqs9/assets/solidgate-add-domain.png?fit=max&auto=format&n=jUS1VyQCpYewnqs9&q=85&s=ee169f2608480ec5f0e7164eb9dbf568" width="1920" height="879" data-path="assets/solidgate-add-domain.png" />
</Frame>

3. Paste your project domain from [Settings > Domains](https://app.funnelfox.com/settings/domains) in FunnelFox and click **Add**. If you have a custom domain, add it as well.

<Info>To use Apple Pay in funnel preview mode, add `http://app.funnelfox.com/` as a domain.</Info>

<Frame>
  <img src="https://mintcdn.com/funnelfox/jUS1VyQCpYewnqs9/assets/solidgate-domain.png?fit=max&auto=format&n=jUS1VyQCpYewnqs9&q=85&s=fceaa5030f39610ab59b78c4b43cc65a" width="1920" height="879" data-path="assets/solidgate-domain.png" />
</Frame>

4. Go to [Settings > Domains](https://app.funnelfox.com/settings/domains) in FunnelFox.

5. Select **Solidgate** under **Apple Pay domain verification**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/xwsBIPAdFUdfrYMh/assets/solidgate-settings-domain.png?fit=max&auto=format&n=xwsBIPAdFUdfrYMh&q=85&s=c231fef1c1081dac3b06108f90597a43" width="1920" height="879" data-path="assets/solidgate-settings-domain.png" />
</Frame>

6. Click **Save**.

<Check>Apple Pay [Wallet button](/docs/elements/wallet-button) will become available in your funnels after domain verification completes.</Check>

<Note>
  Solidgate renders the Apple Pay button only in Safari. On non-Safari
  browsers, the button is not shown. Learn more in the
  [Solidgate documentation](https://docs.solidgate.com/payments/integrate/payment-form/apple-pay-button/#non-safari-browsers).
</Note>

### Google Pay

Google Pay with Solidgate works by default and requires no configuration. Simply add the [Wallet button](/docs/elements/wallet-button) to your funnels.

### Wallet button configuration

The Wallet button element adds a one-tap Apple Pay or Google Pay button to
your funnels. With Solidgate, it can be configured independently or linked
to a Checkout element on the same screen.

Go to the [Wallet button article](/docs/elements/wallet-button) to set it up.

## Testing

Test your Solidgate integration with simulated payments before going live.

1. Configure the test in your Checkout element's **Sandbox** section.

<Frame>
  <img src="https://mintcdn.com/funnelfox/6YHRxIZ7Mqh2GRqE/assets/solidgate-testing.png?fit=max&auto=format&n=6YHRxIZ7Mqh2GRqE&q=85&s=feea440a7928465a175bb5443f3bd860" width="1129" height="871" data-path="assets/solidgate-testing.png" />
</Frame>

2. Open your funnel in **Preview** mode.

<Frame>
  <img src="https://mintcdn.com/funnelfox/6YHRxIZ7Mqh2GRqE/assets/solidgate-testing-preview.png?fit=max&auto=format&n=6YHRxIZ7Mqh2GRqE&q=85&s=c72ab21a5b690bd23a817caf2b797101" width="1129" height="871" data-path="assets/solidgate-testing-preview.png" />
</Frame>

3. Use these Solidgate test cards with any future expiry date and `123` as CVV:

| Card Number         | Scenario          |
| ------------------- | ----------------- |
| 4067 4299 7471 9265 | Success           |
| 4532 4566 1814 2692 | Recurring success |
| 4510 1088 1840 6882 | Declined          |

Learn more about [Solidgate test cards](https://docs.solidgate.com/payments/testing/#card-payments).

## Next steps

* [Configure checkout element](/docs/elements/checkout) in your funnel