Solidgate

Who should use this guideThis guide is intended for merchants who:

Use Payrails as a payment orchestrator
Use Solidgate to accept cards, Apple Pay or Google Pay
Have access to the Solidgate Hub with a channel for each environment

Create a Solidgate integration in Payrails

Log in to the Payrails portal.
Go to Settings → Integrations.
Select Add instance to create a new integration configuration.
Select the workspaces where this integration should be available.

About workspacesWorkspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.

Step 1: Choose the integration type

Select Payment.
Continue to the next step.

Step 2: Choose the provider

Select Solidgate.
Continue to the next step.

A screenshot showing Solidgate selected as the provider.

Step 3: Configure your Solidgate integration

What you’ll need from SolidgateBefore you begin, make sure you can log in to the Solidgate Hub. You’ll copy the API keys and webhook keys of the channel for your environment.

Integration instance name

An integration instance is a specific payment provider setup in Payrails. You can create multiple instances for different regions, currencies, or business needs. Choose a clear, consistent name, as it is used in routing.

In Payrails

Enter an Instance name for your integration, for example merchant_solidgate.

A screenshot showing the integration instance name field.

Payment methods

In Payrails

Select Card, Apple Pay, Google Pay or any combination.

A screenshot showing the Solidgate payment method selection.

Credentials

In Solidgate

In the Solidgate Hub, go to Developers → Channels.
Open the channel for your environment. Use a test channel for test mode and a live channel for live mode.
Under API Keys, copy the Public and Secret keys.
Under Webhook Keys, copy the Public and Secret keys.

In Payrails

Field	Value
API Public Key	The channel’s API public key
API Secret Key	The channel’s API secret key. Payrails signs every request with it.
Webhook Public Key	The channel’s webhook public key
Webhook Secret Key	The channel’s webhook secret key. Payrails uses it to verify notifications from Solidgate.

A screenshot showing the Solidgate credential fields.

Webhooks or notifications

Payrails uses provider webhooks or notifications to receive asynchronous payment status updates.

Set up the webhook on the same Solidgate channel whose keys you entered in Payrails.

In Payrails

Copy the Notification URL shown under Account configuration at the top of the integration form.

In Solidgate

Open the same channel in the Solidgate Hub.
Add the Payrails notification URL as the channel’s webhook URL for order and transaction status updates.
Save the changes.

Solidgate notifies Payrails of authorizations, captures, refunds and voids.

Request fields for Solidgate

Send these fields in the authorize request for card payments, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to Solidgate when you include them. For more about meta fields, refer to Meta fields.

Field	Status	Description
`amount`	Required	Sent to Solidgate as the order amount and currency.
`meta.order.description`	Required	Sent as the order description.
`meta.customer.email`	Required	A valid email address. Sent as the customer email.
`meta.clientContext.ipAddress`	Required	A valid IP address. Sent as the customer’s IP address.
`meta.clientContext.osType`	Required	Sets the platform: `iOS` and `Android` are sent as app payments, anything else as web.
`meta.clientContext.userAgent`, `acceptHeader`, `language`, `colorDepth`, `screenHeight`, `screenWidth`	Required	Only when you force 3D Secure with `meta.risk.threeDSMode` set to `Force`. Sent as browser details for 3D Secure.
`instrument.networkTransactionReference`	Required	Merchant-initiated payments only. Sent as the scheme transaction ID. Payrails stores it from the first payment.
`meta.customer.name`, `meta.customer.lastName`	Optional	Sent as the customer’s first and last name. Payrails also uses them as the card holder name when the instrument has none.
`meta.customer.phone.number`	Optional	Sent as the customer phone.
`meta.customer.birthDate`	Optional	Sent as the customer’s date of birth.
`meta.customer.identityCardNumber`	Optional	Sent as the customer account ID.
`meta.customer.country.iso3`	Optional	Sent as the customer’s country.
`meta.clientContext.origin`, `host`, `clientType`, `javaEnabled`, `timeZoneOffset`	Optional	Sent as the traffic source, website, device and browser details.
`meta.order.billingAddress`	Optional	Sent as the purchase country, postal code, state, city and address.
`meta.order.deliveryAddress`	Optional	Sent as the shipping address.
`meta.order.reference`	Optional	Sent with the order items.
`merchantReference`	Optional	Sent in the order metadata.

Enable the integration

In Payrails

Select Save account to enable the integration.
Confirm the integration shows as Enabled.

Your Solidgate integration is now ready to process payments.

Next steps

Run a test payment using a Solidgate test card.
Verify that:
- The payment appears in the Solidgate Hub.
- The payment status updates correctly in Payrails.
Once verified in test mode, repeat the setup with your live channel.

→ Continue to: Test a payment

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Create a Solidgate integration in Payrails

Step 1: Choose the integration type

Step 2: Choose the provider