Quickstart: use the Creditcorp public API in htmx

2 min read

htmxIdiomatic integration

cacheCatalogue changes rarely

configBase URL from env

Call the API from htmx

<div hx-get="/api/products"
     hx-trigger="load"
     hx-swap="innerHTML">
  Loading finance options\u2026
</div>

With htmx, point hx-get at your own backend route (which proxies and caches the Credicorp catalogue), and let htmx swap the HTML fragment in on load — no client-side JavaScript to write.

Sandbox first

Set the base URL to https://sandbox.credicorp.co.uk/public/v1 in development and CI. See choosing a base URL.

Next steps

Add a quote form or an enquiry submission, and send applicants to apply. Handle failures with the shared error envelope.

Frequently asked questions

Should I cache the catalogue in htmx?

Yes — it changes infrequently. Cache it for the response's max-age using htmx's caching layer, so the API stays off your hot path and under the rate limit.

Where does the base URL belong?

In htmx's configuration, read from an environment variable per environment, so the same build runs against sandbox and production by changing one value.