Home
Home
  1. Mandates
  • Welcome
    • About Ontime
    • Overview
    • Test and Learn Projects
  • Authentication
  • Availability Check
    • Light Availability Check
      POST
    • Full Availability Check
      POST
  • Payment Management
    • Mandates
      • Create a new mandate
        POST
      • Cancel an existing mandate
        DELETE
      • Get a Mandate
        GET
      • Get many Mandates
        GET
    • Payment Requests
      • Instruct a new payment request
      • Cancel an existing payment request
      • Get a Payment
      • Get many Payments
  • Payouts
    • Get a Payout
      GET
    • Get Available Payouts
      GET
  • Webhooks
    • Mandate Created/Updated
    • Payment Request Created/Updated
    • Payout Created
  1. Mandates

Cancel an existing mandate

Developing
Cloud Mock
https://mock.apidog.com/m1/828215-0-default
Cloud Mock
https://mock.apidog.com/m1/828215-0-default
DELETE
https://mock.apidog.com/m1/828215-0-default
/mandates/{mandate_id}
OperationId:cancel_mandate_by_id
Deletes an existing mandate.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Token URL: https://{domain}.auth.{region}.amazoncognito.com
Scopes:
mandates:write-Create and cancel payment mandates.
or
Path Params

Responses

🟢200Success
application/json
Body

🟠409Conflict
🟠404Record Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://mock.apidog.com/m1/828215-0-default/mandates/2892d13d-4389-46d7-babd-6e0871ee1f3f' \
--header 'x-api-key: <api-key>' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "mandate_record": {
        "reference": "e24fd8e6-3181-46a6-a553-19a8cfae9a95",
        "start_date": "2024-12-12T14:23:43.059Z",
        "end_date": "2025-05-14T09:33:39.237Z",
        "authorisation_source": "web",
        "status": "cancelled",
        "limitations": {
            "currency": "EUR",
            "maximum_payment_amount": 1000,
            "percentage_of_payment_amount_accepted": 100
        },
        "id": "81e9f5f5-c6f4-4876-98f4-a3da457c0b1e"
    }
}
Previous
Create a new mandate
Next
Get a Mandate