GoCardless API API Documentation
Cancel a Subscription
POST {{url}}/subscriptions/{{subscription}}/actions/cancel
Immediately cancels a subscription; no more payments will be created under it. Any metadata supplied to this endpoint will be stored on the payment cancellation event it causes. This will fail with a cancellation_failed error if the subscription is already cancelled or finished.
Body
PARAM
| Key | Datatype | Required | Description |
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status OK
| {
"subscriptions": {
"id": "SB000AJY2BWBJ9",
"created_at": "2024-03-04T21:00:19.488Z",
"amount": 88976,
"currency": "USD",
"status": "cancelled",
"name": "orchestrate granular e-commerce",
"start_date": "2024-03-05",
"end_date": "2025-03-06",
"interval": 1,
"interval_unit": "monthly",
"day_of_month": 5,
"month": null,
"count": 12,
"metadata": {
"order_no": "ORDER910"
},
"payment_reference": null,
"upcoming_payments": [],
"app_fee": null,
"links": {
"mandate": "MD000ZG53ED8SZ"
},
"retry_if_possible": true,
"earliest_charge_date_after_resume": null
}
} |
Curl
curl -X POST 'https://api-sandbox.gocardless.com/subscriptions/https://api-sandbox.gocardless.com/actions/cancel'
ENDPOINTS