Skip to content
APIs/Payments/
/
Auto Settlement

Auto Settlement

Request that payments are automatically sentForSettlement following authorization

If any of the AVS/CVC response riskFactors are marked as notMatched the payment will be sentForCancellation automatically.

We recommend disabling cancel on avsNotMatched/cvcNotMatched as shown in the example below. In the next API version (ETA 2026), this functionality will be disabled by default

How to enable

Set instruction.settlement.auto = true to flag the payment as being for debt repayment.

How to disable 'sentForCancellation' flow

By default, a payment will be sentForCancellation if any of the CVC, address or postcode is notMatched.

Set instruction.settlement.cancelOn.cvcNotMatched = disabled and/or instruction.settlement.cancelOn.avsNotMatched = disabled to continue with sentForSettlement.

Example

"instruction": {
...
  "settlement": {
    "auto": true,
    "cancelOn": {
        "cvcNotMatched": "disabled",
        "avsNotMatched": "disabled"
    }
  }