Report

POST /report gives the door the platform's payment reference after payment, keyed by the ATR hash. The door reads a reported payment on the rail before it records it; on a pairing with nothing to read, the seller's report is the settlement.

The requestCopy Anchor Link

A report is either an outcome or a channel's close.

The answersCopy Anchor Link

Retry until a 2xx or a 4xx. A report of money that moved is recorded even when it comes without a claim, and the record then states what is missing.

A report with nothing read yetCopy Anchor Link

Vector CV7 reports a transaction the chain does not yet show as settled. The door records nothing, and the record stays issued:

import type { RecordView, ReportOutcome } from "@integraledger/agentic-connectors";
import { VECTORS } from "@integraledger/agentic-connectors";

const door = process.env.SELLER_DOOR_URL ?? "https://seller.example/door";
const credential = process.env.SELLER_CREDENTIAL ?? "";

async function post(path: string, body: unknown): Promise<Response> {
  return fetch(`${door}${path}`, {
    method: "POST",
    headers: { authorization: `Bearer ${credential}`, "content-type": "application/json" },
    body: JSON.stringify(body),
  });
}

const [issue, reported] = VECTORS["CV7"]!.steps;
await post("/issue", issue!.request.body);
const body = reported!.request.body as unknown as ReportOutcome;
const res = await post("/report", body);
const record = (await res.json()) as RecordView;
console.log(res.status, record.state, record.settlement, record.proves.settledBy);
if (res.status === 202 && record.state === "issued") console.log("nothing read yet: report again later");

202 issued null null
nothing read yet: report again later

Reporting without a claimCopy Anchor Link

Where the pairing reads H from the payment but you did not claim it, send chosen (and request on x402) with the report. The door reads the payment with the keys it takes from them, and the record states claimed: false.

DeclinedCopy Anchor Link

outcome: "declined" records that the seller declined the payment. Nothing is read.

Closing a channelCopy Anchor Link

{ "atrHash": "0x…", "pairing": "mpp/session/tempo", "state": "closed", "reference": "0x…" }

The door reads the close with the keys recorded at the opening, and needs no chosen. See channels.