Quickstart

Quickstart: use the Credicorp public API in React

Here is the idiomatic way to call the Credicorp public API from React. Fetch the product catalogue, cache it, and read the base host from configuration — the same shape you extend later for pricing and quotes, always keeping partner secrets server-side.

2 min read

ReactIdiomatic integration
cacheCatalogue changes rarely
configBase URL from env

Call the API from React

import { useEffect, useState } from 'react';

export function useProducts() {
  const [products, setProducts] = useState([]);
  useEffect(() => {
    const ac = new AbortController();
    fetch(`${import.meta.env.VITE_CREDICORP_BASE}/products`, { signal: ac.signal })
      .then(r => r.json())
      .then(({ data }) => setProducts(data))
      .catch(() => {});
    return () => ac.abort();
  }, []);
  return products;
}

Wrap the call in a `useEffect` with an `AbortController` so it cancels on unmount. Keep the base URL in `import.meta.env` (Vite) or `process.env` (CRA), and never put partner secrets in front-end env vars — anything prefixed for the client is public.

Point at sandbox in development

Set the base URL to https://sandbox.credicorp.co.uk/public/v1 in development and CI, and to https://api.credicorp.co.uk/public/v1 in production — driven by the one environment variable your framework already exposes. See choosing a base URL.

Next steps

From here you can add a quote form, an enquiry submission or an embeddable product picker. Send applicants to apply to start a real journey.

Frequently asked questions

Where should env vars live?

Put the public base URL in a client-exposed env var (VITE_/REACT_APP_). Never expose partner secrets there — client env vars are bundled into the shipped JavaScript.

Should I cache the product list?

Yes. The catalogue changes infrequently, so cache it for the response's max-age. This keeps the API off your hot path and well under the rate limit.

Funding for UK limited companies

Credicorp lends to your company, not to you personally — short-term working capital with no personal guarantee. See what your business could access.