Void

curl --request POST \
  --url https://terminal.smartretry.com/v1/payments/void/ABC123 \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: void-20260331-001' \
  --data '{
    "transaction_reference_id": "TX8A3F2C",
    "order_reference_id": "OR7B9E1D"
  }'

import requests

response = requests.post(
    "https://terminal.smartretry.com/v1/payments/void/ABC123",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Content-Type": "application/json",
        "Idempotency-Key": "void-20260331-001"
    },
    json={
        "transaction_reference_id": "TX8A3F2C",
        "order_reference_id": "OR7B9E1D"
    }
)

print(response.json())

const response = await fetch(
  "https://terminal.smartretry.com/v1/payments/void/ABC123",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": "void-20260331-001"
    },
    body: JSON.stringify({
      transaction_reference_id: "TX8A3F2C",
      order_reference_id: "OR7B9E1D"
    })
  }
);

const data = await response.json();
console.log(data);

{
  "transaction_id": "TX5F1K2L",
  "order_id": "OR7B9E1D",
  "accepted": true
}

{
  "type": "https://terminal.smartretry.com/errors/validation",
  "title": "Bad Request",
  "status": 400,
  "detail": "transaction has already been captured and cannot be voided",
  "reason_code": "TRANSACTION_ALREADY_CAPTURED"
}