Settlement - Payments API

#!/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 node
// Beta. Fetch a settlement batch's status and totals by reference. Node 18+
// ESM fetch. Env: RADIUMONE_ACCESS_TOKEN, RADIUMONE_SETTLEMENT_REFERENCE, RADIUMONE_API_BASE.
const API_BASE = process.env.RADIUMONE_API_BASE || "https://api-sandbox.radiumone.io/gateway";
const accessToken = process.env.RADIUMONE_ACCESS_TOKEN;
const reference = process.env.RADIUMONE_SETTLEMENT_REFERENCE;

async function retrieveSettlementBatch() {
  const res = await fetch(`${API_BASE}/v1/settlement/${reference}`, {
    headers: { Authorization: `Bearer ${accessToken}` },
  });
  const payload = await res.json();
  if (!res.ok) {
    throw new Error(`settlement fetch failed: ${payload.type ?? payload.code} (${res.status})`);
  }
  return payload;
}

retrieveSettlementBatch().then((r) => console.log(JSON.stringify(r, null, 2)));

#!/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))