---
title: "Cancel Payment"
method: POST
path: "/payments/{payment_id}/transactions/{transaction_id}/cancel"
---

# Cancel Payment

`POST /payments/{payment_id}/transactions/{transaction_id}/cancel`

## Path parameters

- `payment_id` string, required
- `transaction_id` string, required

## Request body

- object
  - `description` string — Description of the cancellation.(MAX 255; MIN 3)
  - `reason` 'DUPLICATE' | 'FRAUDULENT' | 'REQUESTED_BY_CUSTOMER' — Reason for the cancellation. Values can be `DUPLICATE`, `FRAUDULENT`, and `REQUESTED_BY_CUSTOMER`.
  - `merchant_reference` string, required — Identification of the payment transaction defined by the merchant (MAX 255; MIN 3).
  - `response_additional_data` object — Specifies additional data for required the transaction response
    - `receipt` boolean — Indicates if a receipt is necessary for the transaction response
    - `receipt_language` 'ES' | 'EN' | 'PT' — Indicates the language of the receipt to be generated
    - `transactions_history` boolean — When true, includes the transactions history in the response
    - `raw_request` unknown
    - `raw_response` boolean — When true, includes the provider raw response in the output

## Response `200`

200

- object
  - `id` string
  - `type` string
  - `status` string
  - `category` string
  - `amount` object
    - `captured` integer
    - `currency` string
    - `currency_conversion` unknown
    - `refunded` integer
    - `value` integer
  - `merchant_reference` string
  - `created_at` string
  - `updated_at` string
  - `provider_data` object
    - `id` string
    - `transaction_id` string
    - `account_id` string
    - `status` string
    - `sub_status` string
    - `status_detail` string
    - `response_message` unknown
    - `response_code` string
    - `raw_request` object — Obfuscated copy of the request Yuno sent to the provider. Only returned for allowlisted organizations.
    - `raw_response` object
      - `message` string
    - `third_party_transaction_id` unknown
    - `third_party_account_id` unknown
    - `iso8583_response_code` string
    - `iso8583_response_message` string
  - `response_code` string
  - `response_message` string
  - `payment` object
    - `id` string
    - `account_id` string
    - `description` string
    - `country` string
    - `status` string
    - `sub_status` string
    - `merchant_order_id` string
    - `created_at` string
    - `updated_at` string
    - `amount` object
      - `captured` integer
      - `currency` string
      - `currency_conversion` unknown
      - `refunded` integer
      - `value` integer
    - `split_marketplace` unknown[]
      - unknown
  - `customer_payer` unknown
  - `simplified_mode` boolean
  - `receipt` boolean
  - `receipt_url` unknown
  - `receipt_language` unknown

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)