Skip to main content

Integrations

Integrations settings Integrations connect your account to payment processors (PSPs). By default, the SF Test-Acquirer is configured for new Sandbox accounts for deterministic testing. You can add as many integrations as you need.

List of integrations

Integrations list in Commerce Dashboard

Create a new integration

Click Add integration (or the equivalent button) to add a processor.
Add new integration – processor selection
The list of available processors depends on the Hellgate backend your account uses.

Edit an integration

Click an integration in the list to edit it.
Edit integration form
The form below Name and Processor depends on the processor. For SF Test Acquirer you can set deterministic test behaviour; for external PSPs you typically configure base URL and credentials.

Flows

Hellgate Commerce supports canonical flows (standard payment patterns) and custom flows (e.g. for preprocessing). The diagram below shows how flows fit into payment handling.
Payment flow: preprocessing and processing stages
Flows settings

Canonical flows

Canonical flows tab
List of canonical payment flows
Click a flow to see its steps and behaviour.

Authorize only

Authorize a payment without capturing.
Authorize-only flow diagram

Authorize with fallback

Authorize with one PSP and fall back to another on failure.
Authorize with fallback flow diagram

Capture

Capture a previously authorized payment.
Capture flow diagram

Charge (two-step)

Authorize and capture in one flow.
Charge two-step flow diagram

Reject

No transaction is sent to a processor; the payment request is failed (useful for reject rules).
Reject flow diagram

Void (open)

Void a payment that was never authorized.
Void open flow diagram

Void (authorized)

Cancel an authorized payment, then void it.
Void after cancel flow diagram

Custom flows

Custom flows (preprocessing) tab New accounts start with an empty list. You can add custom flows as sequences of steps, with branching based on success or failure.
Empty custom flows list
Configure custom preprocessing flow

Flow matrix

Flow matrix The flow matrix defines which flows run in pre-processing and processing, and which integration is used.

Pre-processing flow matrix

Pre-processing flow matrix

Processing flow matrix

The processing matrix always has a default rule that runs authorization with the SF Test Acquirer. You can add rules to route specific payments to other flows or integrations.
Processing flow matrix with default rule

Adding and editing rules

Each rule matches payment data to conditions and assigns flows for the processing steps, plus the integration to use.
Flow matrix rule configuration