Refund

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

import requests

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

print(response.json())

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

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

{
  "transaction_id": "TX2E6G8H",
  "order_id": "OR7B9E1D",
  "merchant_transaction_id": "refund-20260331-001",
  "accepted": true
}

{
  "type": "https://terminal.smartretry.com/errors/validation",
  "title": "Bad Request",
  "status": 400,
  "detail": "transaction_reference_id does not refer to a refundable transaction",
  "reason_code": "INVALID_TRANSACTION_REFERENCE"
}