---
title: "Revoke a Payment Agreement"
method: POST
path: "/v1/payment-agreements/{agreement-id}/revocations"
tags: ["Payment Agreement Revocations"]
---

# Revoke a Payment Agreement

`POST /v1/payment-agreements/{agreement-id}/revocations`

## Path parameters

- `agreement-id` string, required

## Headers

- `Merchant-Id` string, required

## Request body

- unknown

## Response `200`

OK

- AgreementRevocationResponse
  - `status` 'REVOKED' | 'FAILED' — The status of agreement revocation request
  - `failure` ProcessingFailure
    - `failureType` 'INTERNAL_ERROR' | 'INTERNAL_DECLINE' | 'PROVIDER_ERROR' | 'PROVIDER_DECLINE' — The failure type.
    - `failureCode` string — The failure code.
    - `providerFailureCode` string — The payment provider failure code.
    - `failureMessage` string — The failure message.
    - `isRetryable` boolean — Indicates whether the merchant should create a fresh new attempt, where initiating a fresh new attempt at a later time may potentially result in a successful outcome.
    - `additionalData` AdditionalData
      - `merchantAdviceCode` string — Merchant Advice Code (MAC) returned by the payment network on decline, indicating whether and when the payment may be retried.
      - `merchantAdviceCodeText` string — Human-readable explanation of the Merchant Advice Code (MAC).

---

[API](https://skmtc.net/ppro/apis/payment-charges.md) · [All operations](https://skmtc.net/ppro/apis/payment-charges/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ppro/payment-charges/revisions/112e8bb4c815/schema)