Description

n8n-nodes-solidgate

This package adds the Solidgate payment gateway API to your n8n workflows. Use it to process payments, manage subscriptions, handle billing, generate reports, and integrate Solidgate with other services like Klaviyo, Stripe, or any other platform.

n8n is a fair-code licensed workflow automation platform.

• Installation
• Operations
• Credentials
• Compatibility
• Usage
• Resources
• Version history

Installation

Follow the official community node installation guide to add the package to your n8n instance.

The npm package name is n8n-nodes-solidgate.

Operations

The Solidgate node supports all major API resources:

Card Payments

• Charge – Process a card payment charge
• Refund – Refund a card payment
• Void – Void a card payment
• Settle – Settle a card payment
• Recurring – Process a recurring card payment
• Resign – Resign a card payment
• Check Order Status – Check the status of a card order
• Apple Pay – Process Apple Pay payment
• Google Pay – Process Google Pay payment
• Get ARN Codes – Get ARN codes for a transaction

Alternative Payment Methods (APM)

• Init Payment – Initialize an alternative payment method
• Recurring – Process recurring APM payment
• Refund – Refund an APM payment
• Check Order Status – Check APM order status

Billing – Products

• Create Product – Create a new product
• Get Product List – Get list of products
• Update Product – Update an existing product
• Get Product by ID – Get a product by ID
• Archive Product – Archive a product

Billing – Prices

• Create Price – Create a product price
• Get Prices – Get product prices
• Update Price – Update a product price
• Calculate Price – Calculate product price

Billing – Taxes

• Transactional Tax – Calculate transactional tax
• Download Transactional Tax – Download transactional tax report
• Summary Tax – Calculate summary tax
• Download Summary Tax – Download summary tax report

Billing – Subscriptions

• Update Subscription – Update a subscription
• Switch Product – Switch subscription product
• Update Subscription Token – Update subscription token
• Create Pause – Create subscription pause
• Update Pause – Update subscription pause
• Remove Pause – Remove subscription pause
• Cancel Subscription – Cancel a subscription
• Cancel by Customer – Cancel subscriptions by customer
• Restore Subscription – Restore a subscription
• Get Subscription Status – Get subscription status
• Retrieve by Customer – Retrieve subscriptions by customer
• List Invoices by Subscription – List invoices for a subscription
• List Orders by Invoice – List orders for an invoice

Reporting

• Card Orders – Get card orders report
• APM Orders – Get APM orders report
• Subscriptions – Get subscriptions report
• Chargebacks – Get chargebacks report
• PayPal Disputes – Get PayPal disputes report
• Prevention Alerts – Get prevention alerts report
• Download Prevention Alerts – Download prevention alerts report
• Card Fraud Alerts – Get card fraud alerts report
• Financial Entries – Get financial entries report
• Download Financial Entries – Download financial entries report

Risks – Fraud Prevention

• Create List Item – Create fraud prevention list item
• List Items – List fraud prevention items
• Delete Item – Delete fraud prevention list item

Risks – Dispute

• Create Representment – Create dispute representment

Checkout

• Create Payment Page – Create a payment page
• Deactivate Payment Page – Deactivate a payment page
• Create Payment Link – Create a payment link
• Deactivate Payment Link – Deactivate a payment link

Webhooks

• Create Endpoint – Create a webhook endpoint
• List Endpoints – List webhook endpoints
• Update Endpoint – Update a webhook endpoint
• Delete Endpoint – Delete a webhook endpoint

Files

• Create File Upload – Create file upload request

Credentials

1. Sign up for a Solidgate account.
2. Navigate to the Solidgate Hub to get your API credentials:
   • Public Key – Your merchant public key (starts with wh_pk_ or pk_)
   • Secret Key – Your merchant secret key
3. Create a new credential in n8n using the Solidgate API type and enter your keys.
4. Select the environment (Sandbox or Production).

The credential test button issues a test request to verify your credentials.

Compatibility

• Requires n8n v1.40.0 or newer
• Node runtime: requires network egress to https://payment.solidgate.com (production) or https://payment-dev.solidgate.com (sandbox)

Usage

Process a Card Payment

1. Add the Solidgate node to your workflow.
2. Select Card Payments as the resource and Charge as the operation.
3. In the Additional Fields section, add the required payment fields as JSON:

   {
     "order_id": "order_123",
     "amount": 1000,
     "currency": "USD",
     "card_number": "4111111111111111",
     "card_holder": "John Doe",
     "card_exp_month": "12",
     "card_exp_year": "2025",
     "cvv": "123"
   }
   

4. Execute the workflow to process the payment.

Check Order Status

1. Add the Solidgate node and select Card Payments > Check Order Status.
2. In Additional Fields, add:

   {
     "order_id": "order_123"
   }
   

3. Execute to get the order status.

Manage Subscriptions

1. Select Billing – Subscriptions resource.
2. Choose an operation like Update Subscription or Cancel Subscription.
3. Add the required fields in Additional Fields:

   {
     "subscription_id": "sub_123",
     "status": "active"
   }
   

Generate Reports

1. Select Reporting resource.
2. Choose a report type (e.g., Card Orders).
3. Add filter parameters in Additional Fields:

   {
     "date_from": "2024-01-01",
     "date_to": "2024-12-31"
   }
   

Using with Other Services (e.g., Klaviyo)

Example workflow: When a payment is successful in Solidgate, update customer in Klaviyo:

1. Solidgate node: Card Payments > Check Order Status
2. IF node: Check if order status is "approved"
3. Klaviyo node: Update customer profile with payment information

Additional Fields

All operations support an Additional Fields parameter where you can pass any fields required by the Solidgate API. Refer to the Solidgate API documentation for the complete list of available fields for each endpoint.

The node automatically handles:

• Signature generation (HMAC-SHA512)
• Request headers (merchant, signature)
• Environment selection (sandbox/production)

Resources

• Solidgate API Documentation
• Solidgate Payment Guide
• n8n community nodes documentation

Version history