#!/usr/bin/env bash
# Refund against a settled transaction (full or partial, repeatable up to the
# original amount). Only once its batch has CLOSED — see
# snippets/shared/void-or-refund-batch-rule.mdx. Retry the SAME request_id on
# a timeout/5xx.
set -euo pipefail

API_BASE="${RADIUMONE_API_BASE:-https://api-sandbox.radiumone.io/gateway}"
: "${RADIUMONE_ACCESS_TOKEN:?set RADIUMONE_ACCESS_TOKEN to a Bearer access token}"
: "${RADIUMONE_TRANSACTION_ID:?set RADIUMONE_TRANSACTION_ID to the CAPTURED transaction to refund}"

curl -sS -X POST "$API_BASE/v1/transactions/refund/$RADIUMONE_TRANSACTION_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $RADIUMONE_ACCESS_TOKEN" \
  -d @request.json

#!/usr/bin/env python3
"""Refund against a settled transaction, only once its batch has CLOSED — see
snippets/shared/void-or-refund-batch-rule.mdx.
"""
import json
import os
import random
import time
from pathlib import Path

import requests

API_BASE = os.environ.get("RADIUMONE_API_BASE", "https://api-sandbox.radiumone.io/gateway")


def backoff_seconds(attempt: int) -> float:
    """Exponential backoff with jitter: attempt 1 waits ~0.25-0.5s, doubling
    each attempt, capped at 4s -- avoids hammering the gateway in a loop."""
    base = min(0.25 * 2 ** (attempt - 1), 4.0)
    return base + random.random() * base


def refund_transaction(max_attempts: int = 3) -> dict:
    body = json.loads((Path(__file__).parent / "request.json").read_text())
    transaction_id = os.environ["RADIUMONE_TRANSACTION_ID"]
    headers = {"Authorization": f"Bearer {os.environ.get('RADIUMONE_ACCESS_TOKEN', '')}"}

    for attempt in range(1, max_attempts + 1):
        try:
            resp = requests.post(
                f"{API_BASE}/v1/transactions/refund/{transaction_id}", json=body, headers=headers, timeout=30
            )
        except requests.exceptions.Timeout:
            if attempt == max_attempts:
                raise
            time.sleep(backoff_seconds(attempt))
            continue

        if resp.status_code >= 500:
            if attempt == max_attempts:
                raise RuntimeError(f"server error {resp.status_code} after {attempt} attempts")
            time.sleep(backoff_seconds(attempt))
            continue

        payload = resp.json()
        if not resp.ok:
            # 409 tx:refund-on-open-batch — the batch is still open; void instead.
            code = payload.get("type") or payload.get("code")
            raise RuntimeError(f"refund failed: {code} ({resp.status_code})")
        return payload

    raise RuntimeError("unreachable")


if __name__ == "__main__":
    print(json.dumps(refund_transaction(), indent=2))