read.payment

The payment status + neutral next_action for an order (by order_id). Public, PII-free (poll until approved). pending = the current attempt is still open; rejected = the issuer said no; failed = the app ended that attempt; in both terminal cases the order can be paid by a new attempt. opened_at is when the attempt on screen opened and expires_at when its window closes — the window in force for the method (the store’s ficha override, else the app’s declaration), published ONLY while the attempt is still open, so a caller can tell “still worth waiting for” from “nothing more will arrive here”.

• Surface: GET /v1/read/payment · CLI forge read payment · MCP tool read.payment
• Auth: public (no actor; store resolves the tenant)

Params (JSON Schema)

{
  "properties": {
    "order_id": {
      "minLength": 1,
      "type": "string"
    },
    "store": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "store",
    "order_id"
  ],
  "type": "object"
}

Result (200)

Open (unknown) — this capability does not declare an output schema.

Errors

invalid_params (400) · not_found (404)