1. Obtain API credentials from Solidgate

Navigate to Developers → Channel details page in your Solidgate account:

https://docs.solidgate.com/payments/integrate/access-to-api/#retrieve-your-credentials

You will need to obtain the following keys:

API keys with the prefix api_pk_ / api_sk_
Webhook keys with the prefix wh_pk_ / wh_sk_

2. Add credentials to web2wave Project settings

In web2wave Project settings → Payments → Solidgate, fill in all fields:

Public API key (api_pk_xxxxx)
Secret API key (api_sk_xxxxx)
Public Webhook key (wh_pk_xxxxx)
Secret Webhook key (wh_sk_xxxxx)

web2wave Payments tab, Solidgate integration

3. Configure webhook URL (if required during key retrieval)

If Solidgate asks for a webhook URL when obtaining the wh_pk_ / wh_sk_ keys, use this format:

https://PROJECT_ID.web2wave.com/solidgate/webhook

Replace PROJECT_ID with your actual project ID value from the project_id field.

Webhook events to enable:

card_gate.order.updated
alt_gate.order.updated
subscription.updated.v2

You can copy your webhook URL from this field

Note: In the Solidgate panel, these events may have slightly different user-friendly names. Select the corresponding events. After saving all keys in your web2wave project settings, the webhook will auto-update with the correct event subscriptions.

4. Save settings

Click Save in web2wave Project settings. The webhook will be created automatically, and Solidgate integration will be ready to use.

5. Enable Apple Pay button (optional)

To add the Apple Pay button through the Solidgate payment form, verify your domain in the Solidgate panel:

https://docs.solidgate.com/payments/integrate/payment-form/apple-pay-button

The domain verification file is uploaded by default on the web2wave side.

Upload file's text in this field and Save changes

Once you confirm the domain in Solidgate's panel, the Apple Pay button will appear automatically on the payment form.