Cancel scheduled checkout

Provides an option for external clients to cancel an scheduled checkout

Overview

The Checkout Payment Delete API allows clients to request the cancellation of a scheduled checkout payment. The deletion process may require user consent. The API provides information on whether user consent is needed, whether the operation succeeded, or if the client should retry.

Endpoint

DELETE /api/v1/ext/checkout-requests/{id}

Request

Description

The request requires a redirect URL where the user would be redirected after the consent is provided. In case user consent is required to complete the process.

Request Header

api-key : your-api-key

Request body (JSON)

🚧

Please note some HTTP clients libraries drop the body while peforming DELETE requests, please make sure you are sending the body.

{
  "redirectUrl": "https://example.com/redirect-post-sca"
}

Response

Description

The response contains the status of the deletion request. The system may require user consent, may succeed immediately, or may suggest retrying because of an internal bank error.

Success (200 OK)

{
  "consentRequired": false,
  "consentUrl": null,
  "success": true,
  "retryable": false
}

Consent Required (200 OK)

{
  "consentRequired": true,
  "consentUrl": "https://consent-url",
  "success": false,
  "retryable": false
}

Retry Suggested (200 OK)

{
  "consentRequired": false,
  "consentUrl": null,
  "success": false,
  "retryable": true
}

Request Fields

NameInTypeRequiredDescription
idpathstringtrueID to uniquely identify the checkout request payment.
api-keyheaderstringtrueKey to uniquely identify the client.
redirectUrlbodystringtrueWhere the user would be redirected after the consent is provided. (in case of user consent)

Response Fields

NameInTypeDescription
consentRequiredbodybooleanIndicates whether additional user consent is required to process the deletion.
consentUrlbodystringIf consent is required, the URL where the user should provide consent.
successbodybooleanIndicates whether the operation succeeded.
retryablebodybooleanIndicates if the operation failed but may succeed if retried.

πŸ›Ή The payment is now cancelled.