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, defaultm2m_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.
-
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. -
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. -
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/lookupni a settle-ready.
Discovery: /openapi.json y
/.well-known/x402.
Facilitator por defecto: PayAI
(https://facilitator.payai.network).