# Galvida Credit API - guia para agentes

API de cotizacion de credito automotriz para MX, CO, AR, CL, PE.
Se cobra **por consulta**. Sin cuenta, sin registro, sin planes.

## Prueba en 1 llamada (gratis, 3 por IP y dia)

    curl -X POST https://galvida.com/api/v1/quote.php \
      -H 'Content-Type: application/json' \
      -d '{"country":"MX","vehicle_price":350000}'

Respuesta 200 -> el campo `result` trae `monthly_payment`, `cat_pct` y la tabla completa.
La cabecera `X-Galvida-Free-Queries-Remaining` dice cuantas te quedan hoy.

## Cuando se agotan las 3

La 4a llamada responde **HTTP 402** con el bloque `accepts[]` y la cabecera
`PAYMENT-REQUIRED` (base64, x402 v2). Dos rieles:

| scheme | estado | como se paga |
|---|---|---|
| `prepaid-key` | **live** | POST a /api/v1/checkout.php, pack `topup` (USD 5 = 417 consultas). Devuelve `url` de Stripe. Luego manda `X-API-Key`. |
| `x402` | pending_activation | USDC en Base. Falta que el vendedor publique su wallet. |

## Recargar la misma clave (no emite una nueva)

    POST https://galvida.com/api/v1/checkout.php
    {"pack":"topup","api_key":"gv_live_..."}

## Consultar saldo (no gasta consulta)

    GET https://galvida.com/api/v1/status.php   con X-API-Key

## Manifiestos

- https://galvida.com/llms.txt
- https://galvida.com/.well-known/x402
- https://galvida.com/api/openapi.json
- https://galvida.com/api/pricing.json