Cancel a pre-approval

Stop charging a customer under a pre-approval. Needs the collect permission.

DELETE/preapprovals/{reference}

Cancels an approved pre-approval at the provider. Charges under it are rejected from then on, and you get preapproval.cancelled.

referencepathstringrequired

The pre-approval’s external_reference.

Response

The pre-approval, now cancelled.

Request

curl -X DELETE 'https://api.razpay.razonetix.com/v1/preapprovals/gym-membership-sipho' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("https://api.razpay.razonetix.com/v1/preapprovals/gym-membership-sipho", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.delete(
    "https://api.razpay.razonetix.com/v1/preapprovals/gym-membership-sipho",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "success": true,
  "message": "pre-approval cancelled",
  "data": {
    "external_reference": "gym-membership-sipho",
    "provider_id": "momo",
    "provider_ref": "11377cbe-374c-43f6-a019-4fb70e57b617",
    "payer_phone": "26876123456",
    "currency": "SZL",
    "message": "Monthly gym membership Ref 11377CBE",
    "validity_seconds": 31536000,
    "status": "cancelled",
    "metadata": {},
    "created_at": 1760774400,
    "updated_at": 1763452800
  }
}

{ "success": false, "message": "only approved pre-approvals can be cancelled; this one is pending", "data": null }