> ## 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 payment integration

> 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](/integrations/payments/solidgate#subscription-configuration) in your funnel.

### Additional features

* **Cancellation funnels**: Full support for [cancellation flows](/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](/integrations/payments/solidgate#digital-wallets) 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](/elements/checkout#subscription-configuration).

Configure Solidgate products in your funnels:

* [Free trial](/elements/checkout#free-trial)
* [Paid trial](/elements/checkout#paid-trial)
* [Upsell](/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>

## 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, [configure wallet buttons](/integrations/payments/solidgate#wallet-button-configuration) directly in 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 will become available in your funnels after domain verification completes.</Check>

### Google Pay

Google Pay with Solidgate works by default and requires no configuration.

### Wallet button configuration

Click **+ Add** in the Visual editor, then select **Paywall Elements > Wallet Button** and set your configuration:

* **Payment Provider**: Solidgate
* **Config source**: Defines how the button is configured.
  * **Independent**: Configure separately from your Checkout element. Cannot be placed on the same screen with a Checkout or another wallet button.
  * **Linked**: Inherits [product configuration](/elements/checkout#subscription-configuration) from your Checkout element on the same screen. Requires the Apple Pay / Google Pay payment method to be enabled in the Checkout. You can include multiple linked Wallet Buttons and Checkouts on the same screen using [conditional visibility](/elements/overview#conditional-visibility).
* **Fallback**: If the wallet button fails to load or initialize, a simple button appears that triggers the action you’ve configured.

For independent wallet button configuration, you can also set the following:

* **When Payment Succeeds**: Navigation action to trigger when payment is completed.
* **When payment fails or is declined**: Navigation action to trigger when payment fails due to a decline or error (including 3DS).
* **When payment is cancelled by user**: Navigation action to trigger when user clicks the cancel button (if available).
* **Entitlement**: Access level ID for [subscription manager](/integrations/subscription-management).
* **Flow type**: Defines the payment flow depending on what you sell.
  * **One-time**
  * **Subscription**
* **Order description**: Description to be sent for order details to Solidgate.
* **Plan/Price**: Define the Solidgate product or one-time price to sell.
* **Custom purchase value**: Override the actual price in analytics and marketing tracking events. Use this for value-based optimization where you can send a predicted LTV.
  * Leave empty to use the actual product price.

<Warning>For customers with slow internet connections, the linked wallet button may load before the related Checkout element. In this case, the wallet button won’t function, and the fallback button will be triggered automatically.</Warning>

<Frame>
  <img src="https://mintcdn.com/funnelfox/xwsBIPAdFUdfrYMh/assets/solidgate-wallet-button.png?fit=max&auto=format&n=xwsBIPAdFUdfrYMh&q=85&s=daf12713e054aabf4ee193aca82ddd8a" width="1148" height="865" data-path="assets/solidgate-wallet-button.png" />
</Frame>

## 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](/elements/checkout) in your funnel