---
title: "Void a card payment"
slug: "void-a-card-payment"
updated: 2025-02-21T10:44:47Z
published: 2025-02-21T10:44:47Z
canonical: "docs.apcopay.com/void-a-card-payment"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apcopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Void a card payment

After a **card payment** has been authorised, the transaction remains incomplete until it undergoes the [capture](/v1/docs/capture-a-payment) process. If you decide not to proceed with capturing the payment, you have the option to **void** it via our card payments API. Voids are only possible for card payments.

Voids are only possible on transactions which are of transaction type:
- Authorisation (**'Auth'**)
- Purchase (**'Purc'**)

:::(Warning) (Information)
Voids can only be processed within a 24-hour timeframe from the original transaction posting. Should this period elapse, you have the option to process a [refund](/v1/docs/refund-a-payment) or [payout](/v1/docs/card-payouts) instead.

It is not possible:
- To void a transaction which has been captured.
- To void a refund or payout.
:::

:::(Warning) (Contigent on your acquirer)
Some rare acquirers do not support 'Voids'. You can verify this by checking the [acquirer specifications](/v1/docs/acquirers) for the supported transaction types of your acquirer.  Should your acquirer not support `voids`, you have the option to process a [refund](/v1/docs/refund-a-payment) or [payout](/v1/docs/card-payouts)  after the 24-hour waiting period.
:::
:::(Info) (Void on partially captured amount)
You have the flexibility to submit a void request within the initial 24 hours for a partially captured payment, releasing the remaining funds back to the cardholder. If you opt not to request it, we'll automatically void the remaining amount, returning it to the customer when the authorisation expires.
:::

To process a void successfully, you must provide the PSP ID of the authorised payment. The PSP ID is returned in the response when creating a Hosted Payment Page token (HPP Token) or when using our payment operations API.

**Endpoint**


<div style="display: flex; justify-content: space-between; align-items: center; border: 1px solid #e0e0e0; padding: 10px; background-color: #f5f5f5;">
    <strong style="background-color: #1F5CA6; color: #fff; padding: 5px; border-radius: 3px;">PUT</strong>
    <strong style="margin-left: 10px; flex: 1;">/api/directconnect/execute</strong>
    <a href="https://apcopay.redoc.ly/#operation/UpdateorActOnExistingPayment" target="_blank" style="margin-left: 10px;">Try it here</a>
    <br>
    <br>
</div>
<br>

**Request Example**
```
{
  "TransactionType": "VOID",
  "Amount": "1.00",
  "Currency": "EUR",
  "CallBackURL": "www.yourURLhere.com/technicalsupporttool-fe/Listener",
  "IsTest": false,
  "PspId": "750762"
}
``` 

**Response Example**
```
{
"pspid": 738246,
"bankResponse": "Processed",
"bankAccept": "YES",
"cardToken": "9705594a-365d-4157-84a8-5af04bbb8507",
"redirectUrl": null,
"isSuccess": true,
"errorMessage": null
}
```


### Manually Voiding a payment using our Portal ###

Link to portal guide [here](/v1/docs/voiding-a-transaction)