Upload mandate cancellations

Upload a file containing mandate cancellations for batch processing through DebiPay.

PUThttps://api.debipay.co.za/api/v1/mandates/upload-cancellations
Loading code example

Query Parameters

MerchantIdstring

Use this endpoint to upload a file that contains cancellation instructions for one or more mandates. It is intended for bulk cancellation workflows where you want to submit many termination requests in a single file.

This operation is useful for back-office or partner integrations that already manage mandate cancellations in a file-based import process.

Typical use cases

  • Batch-cancel mandates for a merchant or cohort.
  • Process a file exported from another internal system.
  • Perform large-scale mandate cleanup without submitting each cancellation individually.

Request details

The request uses a multipart form upload with a file field named File. The generated request schema in the right panel shows the supported format for your deployment.

Response handling

The API returns a confirmation that the cancellation file was accepted and the batch process was triggered. Follow up with the relevant mandate operations to confirm the resulting state of each mandate.

Use this endpoint when your cancellation workflow is already file-driven; it is more efficient than sending one cancellation request per mandate.