SKU#9 · ruleset ar-rail-matrix-v1

Rail matrix AR

Qué riel aplica para settle USDC, consentimiento fiat o checkout. Son reglas explícitas LupaRiel con el lock settle ≠ consent. No es un oráculo, no un puente on-chain y no un consejo legal.

Endpoint

GET /api/rail/matrix — x402 v2 Exact, $0.01 USDC en Base (eip155:8453, amount atómico 10000). Sin pago responde HTTP 402 + PAYMENT-REQUIRED. case inválido responde 400 { error, hint } — nunca un dump de datos.

Probe (debe ser 402 tras el deploy Directo + wrangler Pages Functions):

curl -sI 'https://lupariel.com/api/rail/matrix?case=m2m_usdc'

Lookup del catálogo sigue en /api/lookup. Settle-ready sigue en /api/condition/settle-ready. HTML y /rieles.json no cambian.

Query

  • case (opcional, default m2m_usdc): m2m_usdc | fiat_consent | checkout

Reglas (hardcodeadas)

Siempre se devuelven los cuatro rieles, en orden x402, ap2, acp, mpp. Roles: settle | mandate | checkout | card_mpp. needs_ars_fiat_hop es true cuando el riel no liquida USDC on-chain solo y necesita hop AR Mercado Pago / tarjetas.

  1. m2m_usdc — x402 settle (hop false). AP2 mandate y ACP checkout (hop true). MPP card_mpp hop false: pago por request USDC M2M, como x402.
  2. fiat_consent — AP2 mandate y ACP checkout aplican (hop true). MPP card_mpp hop true. x402 no aplica: es settle nativo, no un riel de consentimiento fiat.
  3. checkout — ACP checkout y MPP card_mpp aplican (hop true). x402 settle es secundario (applica, hop false). AP2 mandate de apoyo (hop true).

Hubs ES: /x402/, /ap2/, /acp/, /mpp/. EN: pilar /en/agentic-payment-rails/ (no hay hubs EN por riel).

Respuesta 200 (post-pago)

{
  "product": "LupaRiel",
  "kind": "rail_matrix",
  "case": "m2m_usdc",
  "lock": "settle_ne_consent",
  "ruleset": "ar-rail-matrix-v1",
  "rails": [
    {
      "rail": "x402",
      "applies": true,
      "role": "settle",
      "needs_ars_fiat_hop": false,
      "hub_url": {
        "es": "https://lupariel.com/x402/",
        "en": "https://lupariel.com/en/agentic-payment-rails/"
      },
      "why": "Pago por request HTTP 402 Exact+USDC: settle nativo, sin hop ARS."
    }
  ]
}

Qué no es

  • No es un oráculo de precios, liquidez ni compliance.
  • No autoriza ni mueve fondos. El cobro de la llamada es x402 Exact USDC Base.
  • Settle ≠ consentimiento. Esa distinción es el lock.
  • No reemplaza a /api/lookup ni a settle-ready.

Discovery: /openapi.json y /.well-known/x402. Facilitator por defecto: PayAI (https://facilitator.payai.network).