Developer resources
Developer tools

Record an external processor outcome without moving money

post/v1/tenants/{tenant_id}/charging-sessions/{session_id}/settlement-reports
Requires an API key

Requires settlement:write. Application-reported, never independently verified. Append-only provenance and operation-reference deduplication. Pending/unknown can resolve once to succeeded/failed; terminal results and amounts cannot change. Successful captures cannot exceed the final bill; refunds cannot exceed successful captures. No processor webhooks are accepted directly.

Path parameters

  • tenant_idintegerRequired
  • session_idstringRequired

Headers

  • idempotency-keystringRequired

Request body

  • kindenumRequired
    One of authorization, capture, refund, release
  • operation_referencestringRequired
    Stable processor operation ID. Reuse for outcome updates; use a new ID only for a distinct financial operation.
    Pattern ^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,127}$
  • outcomeenumRequired
    One of pending, unknown, succeeded, failed
  • amount_minorintegerRequired
    Integer USD cents. Release uses zero. This reports a fact; it never moves money.
    Minimum 0 · Maximum 10000000000
  • currencystring
    Default "USD"

Returns · 201

  • sequenceintegerRequired
  • idstringRequired
  • session_idstringRequired
  • kindenumRequired
    One of authorization, capture, refund, release
  • operation_referencestringRequired
  • outcomeenumRequired
    One of pending, unknown, succeeded, failed
  • amount_minorintegerRequired
  • currencystringRequired
  • reported_bystringRequired
  • created_atstringRequired
  • verificationstring
    Default "application_reported"
POST /v1/tenants/{tenant_id}/charging-sessions/{session_id}/settlement-reports
curl --fail-with-body -X POST "https://api.ivoracharge.com/v1/tenants/1042/charging-sessions/session_0123456789abcdef/settlement-reports" \
  -H "Authorization: Bearer $IVORA_API_KEY" \
  -H "Idempotency-Key: order-2026-09-30-0001" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "authorization",
  "operation_reference": "string",
  "outcome": "pending",
  "amount_minor": 1250
}'
Response · 201
{
  "sequence": 1,
  "id": "id_0123456789abcdef",
  "session_id": "session_0123456789abcdef",
  "kind": "authorization",
  "operation_reference": "string",
  "outcome": "pending",
  "amount_minor": 1250,
  "currency": "USD",
  "reported_by": "string",
  "created_at": "2026-09-30T17:00:00Z",
  "verification": "application_reported"
}
Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.