Quickstart

curl https://api.rail.cl/v1/links \
  -H "Authorization: Bearer rail_sk_test_…"

[]

curl https://api.rail.cl/v1/widget_tokens \
  -X POST \
  -H "Authorization: Bearer rail_sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_id": "banco_estado"
  }'

{
  "object": "widget_token",
  "id": "wt_a1b2c3d4_sec_…",
  "expires_at": "2026-06-03T20:00:00Z"
}

<script src="https://widget.rail.cl/v1/embed.js"></script>
<script>
  Rail.openWidget({
    token: 'wt_a1b2c3d4_sec_…',
    publishableKey: 'rail_pk_test_…',
    onSuccess: (et) => {
      // Envía el exchange token a tu backend para canjearlo
      fetch('/api/rail-callback', {
        method: 'POST',
        body: JSON.stringify({ exchange_token: et })
      });
    },
  });
</script>

curl https://api.rail.cl/v1/exchange_tokens/et_… \
  -X POST \
  -H "Authorization: Bearer rail_sk_test_…"

{
  "object": "exchange_token",
  "link_id": "link_8a2f4c6e1b9d5037",
  "consumed_at": "2026-06-03T20:01:23Z"
}

curl "https://api.rail.cl/v1/accounts?link_id=link_8a2f4c6e1b9d5037" \
  -H "Authorization: Bearer rail_sk_test_…"

[
  {
    "object": "account",
    "id": "acc_7d2f3a8c1e9b4502",
    "link_id": "link_8a2f4c6e1b9d5037",
    "name": "CuentaRUT",
    "type": "checking",
    "currency": "CLP",
    "balance": {
      "available": 500000,
      "current": 500000
    },
    "last_4": "5678"
  }
]

curl "https://api.rail.cl/v1/accounts/acc_7d2f3a8c1e9b4502/movements?per_page=10" \
  -H "Authorization: Bearer rail_sk_test_…"

[
  {
    "object": "movement",
    "id": "mov_6c8d1f3a9e5b2074",
    "amount": -30000,
    "currency": "CLP",
    "type": "card_payment",
    "description": "MERCADOLIBRE CL",
    "post_date": "2026-06-01T04:00:00+00:00"
  }
]