Cancel an outbound payment#

Eligibility#

Once an outbound payment moves to the executing state or beyond, the payment process has started and cancellation is no longer possible.

Payment type	Cancellable states
Instant outbound payments	`verifying`, `pending_approval`
Future-dated outbound payments	`verifying`, `pending_approval`, `scheduled`

The payment is no longer necessary — for example, the recipient no longer requires the funds, or a business decision changes the need for the payment.
You have concerns about the verification results and do not wish to proceed.
Since outbound payments cannot be directly updated, cancellation is required if any attributes need to be changed. To modify the amount, description, or other parameters, cancel the existing payment and create a new one.

POST https://api.gocardless.com/outbound_payments/{outbound_payment_id}/actions/cancel HTTP/1.1

Create a new outbound payment with the corrected details.

Monitor payment status and understand the full lifecycle.