#!/usr/bin/env bash
# Beta. Fetch a settlement batch's status and totals by reference.
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 with the settlement-read scope}"
: "${RADIUMONE_SETTLEMENT_REFERENCE:?set RADIUMONE_SETTLEMENT_REFERENCE to the batch reference}"

curl -sS "$API_BASE/v1/settlement/$RADIUMONE_SETTLEMENT_REFERENCE" \
  -H "Authorization: Bearer $RADIUMONE_ACCESS_TOKEN"

#!/usr/bin/env python3
"""Beta. Fetch a settlement batch's status and totals by reference."""
import json
import os

import requests

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


def retrieve_settlement_batch() -> dict:
    reference = os.environ["RADIUMONE_SETTLEMENT_REFERENCE"]
    resp = requests.get(
        f"{API_BASE}/v1/settlement/{reference}",
        headers={"Authorization": f"Bearer {os.environ.get('RADIUMONE_ACCESS_TOKEN', '')}"},
        timeout=30,
    )
    payload = resp.json()
    if not resp.ok:
        code = payload.get("type") or payload.get("code")
        raise RuntimeError(f"settlement fetch failed: {code} ({resp.status_code})")
    return payload


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

{
  "data": {
    "batch_date": "2023-12-25",
    "batch_id": "<string>",
    "batch_number": "<string>",
    "presented_currency": "<string>",
    "settlement_currency": "<string>",
    "state": "<string>",
    "total_presented_amount": 123,
    "totals_provisional": true,
    "tx_count": 123,
    "closed_at": "2023-11-07T05:31:56Z",
    "confirmed_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "device_id": "<string>",
    "reconciled_at": "2023-11-07T05:31:56Z",
    "submitted_at": "2023-11-07T05:31:56Z",
    "total_settlement_amount": 123
  },
  "message": "<string>",
  "request_id": "<string>",
  "status": "ok"
}

{
  "detail": "Missing or invalid Bearer token.",
  "status": 401,
  "title": "Authentication Required",
  "type": "urn:radiumone:gateway:authentication-required"
}

{
  "detail": "Insufficient permissions for this operation.",
  "status": 403,
  "title": "Permission Denied",
  "type": "urn:radiumone:gateway:permission-denied"
}

{
  "detail": "The requested resource does not exist.",
  "status": 404,
  "title": "Not Found",
  "type": "urn:radiumone:gateway:not-found"
}

{
  "detail": "An unexpected error occurred.",
  "status": 500,
  "title": "Internal Server Error",
  "type": "urn:radiumone:gateway:internal-server-error"
}