Auto-settle

Auto-settle
Configure automatic settlement to capture authorized payments on schedule, reducing manual effort and accelerating your revenue cycle

This standard payment process includes initially Guide
This process involves the merchant obtaining authorization to hold a customer’s funds, Solidgate communicating with the acquirer to process the transaction, and the merchant settling the transaction.
authorizing funds
and settling after verifying the transaction, effectively reducing the risks of payment returns.

It starts with payment initiation, followed by encryption and fraud checks, and concludes with authorization by the issuing bank after thorough verification. Once the payment is successfully authorized, the settle step transfers funds from the customer’s account to the merchant’s account.


Usage terms

Auto-settlement conditions:

  • Define payment_type of the transaction as CIT/MIT to understand the maximum value.
  • Specify settle_interval value.

Auto-settlement is performed if:

  • order status is auth_ok , and there is
    • no Guide
      The settle method ensures the settlement of previously authorized transactions.
      settle
      transaction in status processing exists, and
    • no Guide
      The void request serves to nullify pre-existing auth transactions by revoking the initial authorization.
      void
      transaction in any status
Auto-settle configuration

When initiating a payment that uses auto-settle with settle_interval, the transaction begins with a processing Guide
Follow card payment orders through each processing stage with clear status definitions, available actions, and real-time event tracking.
status,
indicating the authorization request is underway and awaiting a final result. If fund authorization is not completed, settlement is paused until authorization is successful, status changes to auth_ok . At auth_ok , funds are confirmed reserved, and product access can be granted. The system then schedules the settlement operation, finalizing the transaction.

If the first transaction attempt to complete the payment fails, the system retries up to six times within 24 hours, every 4 hours, regardless of the settle_interval. Auto-calculation process starts 3 minutes before the settle_interval and continues for 24 hours if needed. For orders with incomplete fund authorization, the settlement process is not initiated.

Transactions with one or more cancelled operations are not automatically completed, ensuring that only valid and complete transactions are processed.


Settlement terms

Defining the payment_type of the transaction as either customer-initiated (CIT) or merchant-initiated (MIT) is important for determining the maximum settlement interval for VISA payments. In addition, the type of card brand may dictate specific checks that must be applied to ensure that all transactions meet the defined limits and rules the payment network sets.

Solidgate handles the settlement process based on the transaction payment_type and card scheme.

  • CIT Visa payments: Maximum 240 hours (10 days).
  • MIT Visa payments: Maximum 120 hours (5 days).
    If the transaction is MIT and the specified settle_interval exceeds 120 hours, like for CIT, it is adjusted to 120 hours, in line with Visa’s merchant-initiated payment limits.
  • Other payment systems: Maximum 168 hours (7 days).
    If the card is identified as non-Visa and the specified settle_interval exceeds 168 hours, it is limited to 168 hours.

Solidgate recommends setting the settle_interval close to 144 hours (6 days) for Visa transactions to improve Guide
Navigate Visa monitoring program requirements with threshold calculations, tier-based escalation rules, and best practices with resolution steps.
VAMP
ratios according to Visa standards. This applies to one-time, trial, primary billing, recurring, and non-subscription upsell payments. This extended authorization period helps mitigate Guide
Analyze fraud metrics across transactions, review detection patterns, and build prevention strategies to minimize losses and liability.
fraud
and Guide
Respond to chargebacks with structured dispute workflows including reason code analysis, evidence collection, and representment submission.
chargebacks
risks, as disputes cannot be filed against authorized but unsettled transactions.

Additionally, Solidgate ensures smooth settlement by comparing the settlement limit on the Payment Service Provider (PSP) side with the specified settle_interval set by the merchant for the product.

If the PSP's maximum settlement period is shorter than the specified settle_interval, the system adjusts the interval to match the PSP's limit, for:
168 hours Adyen, Checkout, dLocal, Ecardon, Emerchantpay, LiqPay, Monobank, Payabl, Paycom, Paysafe, Rapyd, Revolut, Shift4, Truevo, Trust Payments, Unlimit, Valitor, Valitor PF (Rapyd)
143 hours Nuvei
120 hours Acquiring Solidgate, Airwallex, Finby, Fiserv, TSYS, Wells Fargo
113 hours Stripe
96 hours Bamboo Payment
72 hours Braintree, JPMorgan, Worldpay, Worldpay PF
71 hours Ebanx

If the PSP does not specify a maximum period or if their maximum is longer than the specified settle_interval, no changes are made to the settlement date.

In all these cases, the system manages settlements based on the set interval, eliminating the need for a separate settle API request.


Recurring payments

The settle_interval parameter defined for a Guide
Customize, update, and manage products and pricing efficiently.
product
applies universally to both initial and subsequent recurring transactions associated with that product. For products with trial periods, the initial payment’s settlement interval is defined separately by the trial settings, whereas subsequent recurring payments follow the primary product’s configuration.


Looking for help? Contact us
Stay informed with Changelog