---
agentTools:
  projectIndex: https://mk-bank.readme.io/llms.txt
---

# Cancel instant charge

The Cancel Instant Charge endpoint allows you to cancel a specific instant charge using its transaction ID (TXID), just pass the new TXID as a parameter to cancel an existing charge. Use this endpoint to cancel an ongoing or scheduled instant charge. Once cancelled, the charge will no longer be valid and any associated transactions or payments will be void.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "MK Bank Account API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://core-h.mkbank.com.br/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/pix/cob/{txid}/cancel": {
      "put": {
        "summary": "Cancel instant charge",
        "description": "The Cancel Instant Charge endpoint allows you to cancel a specific instant charge using its transaction ID (TXID), just pass the new TXID as a parameter to cancel an existing charge. Use this endpoint to cancel an ongoing or scheduled instant charge. Once cancelled, the charge will no longer be valid and any associated transactions or payments will be void.",
        "operationId": "cancel-instant-charge",
        "parameters": [
          {
            "name": "txid",
            "in": "path",
            "description": "Transaction ID",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"id\": 45289,\n    \"uuid\": \"c244c99e4cc2470c86bab1b4762067e1\",\n    \"txid\": \"467cbd44fdc240b48acb82825579kdj2\",\n    \"account_id\": 1060,\n    \"pix_location_id\": 45289,\n    \"type\": \"COB\",\n    \"expiration_time\": \"3600\",\n    \"expiration_date\": null,\n    \"validate_after_expiration\": null,\n    \"debtor_document_number\": \"01010101010\",\n    \"debtor_name\": \"João teste\",\n    \"amount\": 25,\n    \"pix_key\": \"1aaaa632-bf08-4696-a624-a286464eee1e\",\n    \"status\": \"REMOVIDA_PELO_USUARIO_RECEBEDOR\",\n    \"payer_request\": \"divida de emprestimo\",\n    \"additional_information\": [\n        {\n            \"nome\": \"emprestimo\",\n            \"valor\": \"Nome do produto\"\n        }\n    ],\n    \"created_at\": \"2023-07-24T20:03:06.000000Z\",\n    \"updated_at\": \"2023-07-24T20:45:13.000000Z\",\n    \"debtor_address_line\": null,\n    \"debtor_city\": null,\n    \"debtor_state\": null,\n    \"debtor_zip_code\": null,\n    \"fine_amount\": null,\n    \"fine_type\": null,\n    \"interest_amount\": null,\n    \"interest_type\": null,\n    \"discount_amount\": null,\n    \"discount_date\": null,\n    \"discount_type\": null\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "example": 45289,
                      "default": 0
                    },
                    "uuid": {
                      "type": "string",
                      "example": "c244c99e4cc2470c86bab1b4762067e1"
                    },
                    "txid": {
                      "type": "string",
                      "example": "467cbd44fdc240b48acb82825579kdj2"
                    },
                    "account_id": {
                      "type": "integer",
                      "example": 1060,
                      "default": 0
                    },
                    "pix_location_id": {
                      "type": "integer",
                      "example": 45289,
                      "default": 0
                    },
                    "type": {
                      "type": "string",
                      "example": "COB"
                    },
                    "expiration_time": {
                      "type": "string",
                      "example": "3600"
                    },
                    "expiration_date": {},
                    "validate_after_expiration": {},
                    "debtor_document_number": {
                      "type": "string",
                      "example": "01010101010"
                    },
                    "debtor_name": {
                      "type": "string",
                      "example": "João teste"
                    },
                    "amount": {
                      "type": "integer",
                      "example": 25,
                      "default": 0
                    },
                    "pix_key": {
                      "type": "string",
                      "example": "1aaaa632-bf08-4696-a624-a286464eee1e"
                    },
                    "status": {
                      "type": "string",
                      "example": "REMOVIDA_PELO_USUARIO_RECEBEDOR"
                    },
                    "payer_request": {
                      "type": "string",
                      "example": "divida de emprestimo"
                    },
                    "additional_information": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "nome": {
                            "type": "string",
                            "example": "emprestimo"
                          },
                          "valor": {
                            "type": "string",
                            "example": "Nome do produto"
                          }
                        }
                      }
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2023-07-24T20:03:06.000000Z"
                    },
                    "updated_at": {
                      "type": "string",
                      "example": "2023-07-24T20:45:13.000000Z"
                    },
                    "debtor_address_line": {},
                    "debtor_city": {},
                    "debtor_state": {},
                    "debtor_zip_code": {},
                    "fine_amount": {},
                    "fine_type": {},
                    "interest_amount": {},
                    "interest_type": {},
                    "discount_amount": {},
                    "discount_date": {},
                    "discount_type": {}
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"message\": \"Resource not found\",\n    \"code\": 0,\n    \"data\": []\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Resource not found"
                    },
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {}
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "6297b52a229a9b00142bff3c:63c6c339d666c4000fb932fe"
}
```