Add a quote illustration to your site
Show visitors an example cost from Credicorp’s own data. Call the MCP GetQuote tool with an amount and term, render the…
Read →
Build a product-comparison page with MCP
Power a product-comparison page from Credicorp’s own data via MCP. Call ListProducts for the line-up (Business Loan, Credicorp…
Read →
Build a resilient API client
A production client needs five habits. Set timeouts, retry only transient errors with jittered backoff, honour Retry-After,…
Read →
Build a status badge from a cacheable read
Show a "systems normal" badge driven by a cacheable public read. Poll a cheap read like the loyalty tiers on a slow interval,…
Read →Build an application assistant with MCP
Compose the public MCP tools into an assistant: eligibility_criteria to qualify, get_quote to price, how_to_apply to guide, then…
Read →Build an idempotent webhook consumer
Credicorp delivers webhooks at-least-once, so duplicates and out-of-order arrivals are normal. De-duplicate on the event ID,…
Read →Cache OAuth tokens across your workers
Mint an access token once and share it across every worker. Key the cache by (client, scope), store the absolute expiry, and…
Read →Cache the loyalty ladder for performance
Cache the loyalty ladder and you all but remove it from your load budget. A five-minute shared cache, keyed on the response’s…
Read →Call the MCP server with JSON-RPC
Drive the public MCP server by hand with three JSON-RPC calls: initialize, tools/list, then tools/call on get_quote. No token, no…
Read →Call the public API from Node.js
Call the Credicorp public API from Node with the built-in fetch. Read the loyalty tiers, post an enquiry, and handle a 429 — all…
Read →Call the public API from PHP
Call the Credicorp public API from PHP with curl. Read the loyalty ladder and post an enquiry using the curl extension, with a…
Read →Call the public API from Python
Call the Credicorp public API from Python with requests. Read the loyalty ladder and post an enquiry, honouring the Retry-After…
Read →Capture a lead with POST /public/v1/enquiries
Send accepted form submissions to the public enquiries endpoint. Capture consent first, run your own anti-abuse client-side, and…
Read →Connect an AI agent to Credicorp over MCP
Give an AI agent accurate Credicorp product knowledge by connecting it to the MCP server. Point any Model Context Protocol client…
Read →Debug a 422 validation error
A 422 means your request parsed but a value failed a rule. The envelope tells you exactly which: error.code names the rule,…
Read →Diagnose a 401 or 403
401 and 403 are different failures. A 401 means your credential was missing or invalid — the platform does not know who you are…
Read →
Embed a Credicorp comparison listing
Render an accurate Credicorp listing on a comparison site from two public reads — products and pricing — plus a live quote. No…
Read →Embed the Credicorp support widget
Add live support to any page with two tags. Load the widget stylesheet in the head and the widget script with defer, and the…
Read →Expose Credicorp tools to Claude via MCP
Point a Claude agent at the public MCP server and it can quote, qualify and guide from live Credicorp figures. Register the…
Read →Fix consent_required errors
consent_required is the most common enquiry rejection. The public enquiry endpoint requires fields.consent to equal the string…
Read →Handle a flag-gated empty state cleanly
Make your UI correct whether a feature is on or off. Flag-gated endpoints like the Slice biller registry return a clean empty…
Read →Handle out-of-order webhooks
Webhook delivery is unordered. A retried payment.failed can land after the payment.succeeded that superseded it. Never drive…
Read →Handle payment.failed webhooks
A payment.failed webhook needs a humane, correct response. Read the failure_code to understand why, trigger a supportive outreach…
Read →Handle rate limits and back off correctly
Do not guess your remaining budget — read the RateLimit- headers, slow down before the wall, and on a 429 wait for Reset with…
Read →Handle rate limits gracefully
The public ring allows 60 requests per 60 seconds per IP. Cross it and you get a 429 with Retry-After. Avoid it with client-side…
Read →Handle rate limits gracefully
Handle the public ring’s 60/60 s limit without drama. On a 429, read Retry-After, wait that long, and retry once. Add jitter if…
Read →Handle the quote range error gracefully
The quote endpoint returns a 422 when amount or term is out of range. Clamp inputs up front, read the bound from the error…
Read →
Headless-render a CMS page
Pull published Credicorp copy into your own front end from one keyed read. GET /public/v1/cms/pages/{key} returns sanitised,…
Read →Initialize an MCP client against Credicorp
Point a standards MCP client at /public/v1/mcp: fetch the server card, initialize, tools/list, then register the tools with your…
Read →Keep a comparison page fresh with live data
Never let a comparison page drift from the truth. Read products, details and indicative quotes from the MCP server — at build…
Read →List Slice billers safely
List the billers a customer can spread a bill across — and handle the off state cleanly. GET /public/v1/slice/billers returns…
Read →Log and observe your API calls
Instrument every call: capture the request ID, record RateLimit headers, redact secrets, and alert on error-rate and latency…
Read →Make a webhook handler idempotent
At-least-once delivery means the same event can arrive twice — after a slow acknowledgement or a retry. Deduplicate on the event…
Read →Make your first public-API call
Your first call to the Credicorp public API takes about a minute and needs no credentials. Read the loyalty ladder with a single…
Read →Map errors to user-facing messages
Users should never see a raw API error. Branch on the stable error.code, keep the developer-facing message in your logs, and show…
Read →Migrate from scraping to the API
If you scrape Credicorp figures today, map each value to an endpoint and cut over. Products, pricing, quotes and loyalty are all…
Read →Mirror partner state into your systems with webhooks
Mirror Credicorp state by consuming webhooks idempotently and reconciling with reads after any outage. Webhooks push the deltas;…
Read →Mirror the loyalty ladder in a mobile app
Show the loyalty ladder in a native or mobile app from one cached fetch. Pull the tiers on launch, cache them locally keyed on…
Read →Mirror webhook events into a queue
Acknowledge fast by enqueuing, not processing. Verify the signature, push the raw event onto your own queue, and return 200 in…
Read →Monitor public-API health from your side
Watch the public API from your side with a light touch. A periodic GET on a cacheable endpoint like the loyalty tiers is a fine…
Read →Monitor webhook endpoint health
A silently failing endpoint loses events, then gets disabled after 7 days. Monitor delivery success from your side, alert on a…
Read →Move from the public API to the partner API
When you need accounts, offers or payments, you have outgrown the public ring. The public API is for reads and safe submissions;…
Read →Paginate a partner collection
Walk a partner collection with cursor pagination: pass a limit, follow next_cursor until it is null, and page at a sensible size…
Read →Proxy the public API from your server
Proxy public reads through your backend when you want shared caching, a single egress IP, or to aggregate figures. Mind that the…
Read →Proxy the public API through your backend
Put your own backend in front of the public API and everything gets easier. A thin proxy lets you cache reads once for all users,…
Read →Quickstart: Add metrics and tracing to your API calls
Wrap every call in a span and a timer, tag it with the request_id, and you get latency, error-rate and end-to-end tracing for…
Read →Quickstart: Build a live repayment illustration
A live illustration that quotes as the user moves a slider feels great — debounce it so you respect the rate limit. This recipe…
Read →Quickstart: Build a product comparison table
Rendering a comparison table straight from GET /public/v1/products gives readers an always-current view of what Credicorp offers…
Read →Quickstart: Cache the product catalogue correctly
The catalogue changes rarely, so caching it removes the API from your hot path and keeps you well under the rate limit. This…
Read →Quickstart: Credicorp public API for a B2B marketplace
You run a B2B marketplace and want to offer financing to buyers or sellers at the point of need. This quickstart shows the exact…
Read →Quickstart: Credicorp public API for a broker or introducer CRM
You are a commercial-finance broker and want to pre-qualify and submit clients without leaving your CRM. This quickstart shows…
Read →Quickstart: Credicorp public API for a business-finance comparison site
You are running a comparison or aggregator site and want Credicorp in your line-up. This quickstart shows the exact endpoints and…
Read →Quickstart: Credicorp public API for a digital agency building for clients
You are an agency building sites for business clients and want a reusable funding widget. This quickstart shows the exact…
Read →Quickstart: Credicorp public API for a native mobile app
You are building a native app and want to offer Credicorp funding to your business users. This quickstart shows the exact…
Read →Quickstart: Credicorp public API for a no-code / automation workflow
You want to connect a form or CRM to Credicorp without writing a service, using a no-code automation tool. This quickstart shows…
Read →Quickstart: Credicorp public API for an accountancy client portal
You run an accountancy practice portal and want to surface business-funding options to clients. This quickstart shows the exact…
Read →Quickstart: Credicorp public API for an e-commerce or SaaS platform
You run a platform whose merchants are limited companies, and you want to offer them working capital. This quickstart shows the…
Read →Quickstart: Cut bandwidth with conditional requests
When the API sends an ETag, a conditional request lets you skip the body entirely if nothing changed — a 304 and no payload. This…
Read →Quickstart: Debug a failing public API call
When a call fails, work from the network inward: prove reachability, read the exact status and error code, then reproduce with a…
Read →Quickstart: Format amounts as GBP for UK readers
Amounts come back as plain numbers in GBP; format them with the platform's own number formatter, not string concatenation. This…
Read →Quickstart: Gate features on live API status
Read the status endpoint on a schedule and gate live-API features off the cached result, so an outage degrades quietly. This…
Read →Quickstart: Generate a client from the OpenAPI description
Generating your client from the OpenAPI spec means your types can never drift from the API — regenerate on every contract change…
Read →Quickstart: Keep partner secrets off the client
The single rule that matters when you graduate from public reads to partner writes: a client secret must never reach the browser…
Read →Quickstart: Keep regulated copy in sync with the CMS
Regulated copy must match the source exactly; fetch it by key and refresh when updated_at changes rather than pasting and…
Read →Quickstart: Localise copy and figures for UK readers
Credicorp is a UK lender to limited companies, so your integration's copy and figures should be unambiguously British. This…
Read →Quickstart: Log requests with the request id
The request_id on every response is your thread back to a specific call — log it structured, on success and failure alike. This…
Read →Quickstart: Make your finance widget accessible
A funding widget must be usable by everyone — semantic HTML, keyboard support and a live region for the quote result get you to…
Read →Quickstart: Mock the public API in unit tests
For fast unit tests, mock the API with a recorded fixture instead of a live call — reserve the sandbox for integration tests…
Read →Quickstart: Optimise your finance widget's performance
A funding widget should add near-zero weight — defer the script, cache the data, reserve its space and lazy-load it below the…
Read →Quickstart: Proxy the public API through your backend
A thin backend proxy lets you cache, trim payloads and keep one origin for your front-end — and it is the seam where partner…
Read →Quickstart: Rate-limit your own widget's API usage
A busy page can flood the API on its own; debounce writes, cache reads and coalesce duplicate in-flight calls to stay a good…
Read →Quickstart: Replace a hard-coded price table with live data
Replacing a stale hand-maintained price table with live API data is low-risk if you fetch behind a flag, diff first, then cut…
Read →Quickstart: Serve the catalogue behind your CDN
Put your CDN in front of the catalogue with a stale-while-revalidate policy and readers get edge-speed data while the API sees…
Read →Quickstart: Test your integration against the sandbox
The sandbox returns deterministic data, so you can assert on exact values in CI without your tests flaking. This recipe shows the…
Read →Quickstart: Understand webhooks: public vs partner
The public ring is request/response only; webhooks live on the authenticated partner ring, because event callbacks carry account…
Read →Quickstart: Validate a UK company number before enquiry
Validating the company number before you POST an enquiry saves a round-trip and gives the applicant instant, friendly feedback…
Read →Quickstart: Wire a support chat into your own UI
Building your own chat UI on the support endpoint is straightforward: post a message, keep the conversation_id, render the reply…
Read →Quickstart: Wrap the public API in your GraphQL schema
If your app speaks GraphQL, wrap the REST public ring in resolvers so your front-end queries products and quotes in your own…
Read →Quickstart: Write a typed client in TypeScript
A handful of interfaces gives you end-to-end type safety over the public API — products, quotes and the shared error envelope…
Read →Quickstart: add a Credicorp finance option to a EV charge point installer website
Adding a Credicorp funding option to a EV charge point installer website is one client-side snippet with no backend. Fund units…
Read →Quickstart: add a Credicorp finance option to a HR consultancy website
Adding a Credicorp funding option to a HR consultancy website is one client-side snippet with no backend. Hire and invest in…
Read →Quickstart: add a Credicorp finance option to a HVAC contractor website
Adding a Credicorp funding option to a HVAC contractor website is one client-side snippet with no backend. Fund parts and a…
Read →Quickstart: add a Credicorp finance option to a IT support company website
Adding a Credicorp funding option to a IT support company website is one client-side snippet with no backend. Stock hardware and…
Read →Quickstart: add a Credicorp finance option to a SEO agency website
Adding a Credicorp funding option to a SEO agency website is one client-side snippet with no backend. Fund a hire and tooling…
Read →Quickstart: add a Credicorp finance option to a accountancy practice website
Adding a Credicorp funding option to a accountancy practice website takes one client-side snippet and no backend. Smooth the…
Read →Quickstart: add a Credicorp finance option to a aesthetic clinic website
Adding a Credicorp funding option to a aesthetic clinic website takes one client-side snippet and no backend. Spread the cost of…
Read →Quickstart: add a Credicorp finance option to a agricultural contractor website
Adding a Credicorp funding option to a agricultural contractor website takes one client-side snippet and no backend. Fund…
Read →Quickstart: add a Credicorp finance option to a agriculture business website
Adding a Credicorp funding option to a agriculture business website is one client-side snippet with no backend. Bridge the gap…
Read →Quickstart: add a Credicorp finance option to a amazon seller website
Adding a Credicorp funding option to a amazon seller website is one client-side snippet with no backend. Fund inventory ahead of…
Read →Quickstart: add a Credicorp finance option to a animation studio website
Adding a Credicorp funding option to a animation studio website is one client-side snippet with no backend. Fund crew and…
Read →Quickstart: add a Credicorp finance option to a antique dealer website
Adding a Credicorp funding option to a antique dealer website takes one client-side snippet and no backend. Fund stock purchases…
Read →Quickstart: add a Credicorp finance option to a appliance repair firm website
Adding a Credicorp funding option to a appliance repair firm website takes one client-side snippet and no backend. Stock parts…
Read →Quickstart: add a Credicorp finance option to a architecture practice website
Adding a Credicorp funding option to a architecture practice website takes one client-side snippet and no backend. Bridge project…
Read →Quickstart: add a Credicorp finance option to a bakery website
Adding a Credicorp funding option to a bakery website takes one client-side snippet and no backend. Spread the cost of an oven, a…
Read →Quickstart: add a Credicorp finance option to a barbershop website
Adding a Credicorp funding option to a barbershop website takes one client-side snippet and no backend. Fit out a new chair, a…
Read →Quickstart: add a Credicorp finance option to a beauty salon website
Adding a Credicorp funding option to a beauty salon website takes one client-side snippet and no backend. Fund equipment, refits…
Read →Quickstart: add a Credicorp finance option to a bike shop website
Adding a Credicorp funding option to a bike shop website takes one client-side snippet and no backend. Build seasonal stock and…
Read →Quickstart: add a Credicorp finance option to a boatyard website
Adding a Credicorp funding option to a boatyard website takes one client-side snippet and no backend. Fund a haul-out season's…
Read →Quickstart: add a Credicorp finance option to a bookkeeping practice website
Adding a Credicorp funding option to a bookkeeping practice website takes one client-side snippet and no backend. Invest in…
Read →Quickstart: add a Credicorp finance option to a branding agency website
Adding a Credicorp funding option to a branding agency website is one client-side snippet with no backend. Hire ahead of a won…
Read →Quickstart: add a Credicorp finance option to a brewery website
Adding a Credicorp funding option to a brewery website takes one client-side snippet and no backend. Fund tanks, kegs and a duty…
Read →Quickstart: add a Credicorp finance option to a butcher website
Adding a Credicorp funding option to a butcher website is one client-side snippet with no backend. Fund refrigeration, stock and…
Read →Quickstart: add a Credicorp finance option to a commercial caterer website
Adding a Credicorp funding option to a commercial caterer website is one client-side snippet with no backend. Fund equipment and…
Read →Quickstart: add a Credicorp finance option to a commercial photography studio website
Adding a Credicorp funding option to a commercial photography studio website is one client-side snippet with no backend. Fund kit…
Read →Quickstart: add a Credicorp finance option to a construction firm website
Adding a Credicorp funding option to a construction firm website takes one client-side snippet and no backend. Fund materials and…
Read →Quickstart: add a Credicorp finance option to a copywriting studio website
Adding a Credicorp funding option to a copywriting studio website is one client-side snippet with no backend. Hire ahead of a…
Read →Quickstart: add a Credicorp finance option to a dental laboratory website
Adding a Credicorp funding option to a dental laboratory website is one client-side snippet with no backend. Fund milling…
Read →Quickstart: add a Credicorp finance option to a design studio website
Adding a Credicorp funding option to a design studio website is one client-side snippet with no backend. Invest in kit and a hire…
Read →Quickstart: add a Credicorp finance option to a event hire company website
Adding a Credicorp funding option to a event hire company website is one client-side snippet with no backend. Build stock ahead…
Read →Quickstart: add a Credicorp finance option to a exhibition stand builder website
Adding a Credicorp funding option to a exhibition stand builder website is one client-side snippet with no backend. Fund…
Read →Quickstart: add a Credicorp finance option to a florist website
Adding a Credicorp funding option to a florist website is one client-side snippet with no backend. Fund seasonal stock ahead of…
Read →Quickstart: add a Credicorp finance option to a health and safety consultant website
Adding a Credicorp funding option to a health and safety consultant website is one client-side snippet with no backend. Fund…
Read →Quickstart: add a Credicorp finance option to a physiotherapy clinic website
Adding a Credicorp funding option to a physiotherapy clinic website is one client-side snippet with no backend. Fund equipment…
Read →Quickstart: add a Credicorp finance option to a picture framer website
Adding a Credicorp funding option to a picture framer website is one client-side snippet with no backend. Fund a workshop fit-out…
Read →Quickstart: add a Credicorp finance option to a print finisher website
Adding a Credicorp funding option to a print finisher website is one client-side snippet with no backend. Fund finishing kit and…
Read →Quickstart: add a Credicorp finance option to a private medical clinic website
Adding a Credicorp funding option to a private medical clinic website is one client-side snippet with no backend. Spread the cost…
Read →Quickstart: add a Credicorp finance option to a recording studio website
Adding a Credicorp funding option to a recording studio website is one client-side snippet with no backend. Fund equipment and a…
Read →Quickstart: add a Credicorp finance option to a sign and display firm website
Adding a Credicorp funding option to a sign and display firm website is one client-side snippet with no backend. Fund a printer…
Read →Quickstart: add a Credicorp finance option to a specialty coffee roaster website
Adding a Credicorp funding option to a specialty coffee roaster website is one client-side snippet with no backend. Fund a…
Read →Quickstart: add a Credicorp finance option to a training provider website
Adding a Credicorp funding option to a training provider website is one client-side snippet with no backend. Fund course…
Read →Quickstart: add a Credicorp finance option to a video production company website
Adding a Credicorp funding option to a video production company website is one client-side snippet with no backend. Fund…
Read →Quickstart: add a Credicorp finance option to a virtual assistant agency website
Adding a Credicorp funding option to a virtual assistant agency website is one client-side snippet with no backend. Fund a hire…
Read →Quickstart: add a Credicorp finance option to a web design agency website
Adding a Credicorp funding option to a web design agency website is one client-side snippet with no backend. Hire ahead of a…
Read →Quickstart: add timeouts and retries to a Node.js API client
A production API client needs a timeout and a retry policy. In Node, an AbortController bounds every request and a small retry…
Read →Quickstart: call the Credicorp public API from Bun
Here is the idiomatic Bun way to make your first Credicorp public API call. List the live products from GET /public/v1/products,…
Read →Quickstart: call the Credicorp public API from C# / .NET
Here is the idiomatic C# / .NET way to make your first Credicorp public API call. List the live products from GET…
Read →Quickstart: call the Credicorp public API from Dart / Flutter
Here is the idiomatic Dart / Flutter way to make your first Credicorp public API call. List the live products from GET…
Read →Quickstart: call the Credicorp public API from Deno
Here is the idiomatic Deno way to make your first Credicorp public API call. List the live products from GET /public/v1/products,…
Read →Quickstart: call the Credicorp public API from Elixir
Here is the idiomatic Elixir way to make your first Credicorp public API call. List the live products from GET…
Read →Quickstart: call the Credicorp public API from Go
Go's standard library is all you need to call the Credicorp public API. This quickstart uses net/http and encoding/json to list…
Read →Quickstart: call the Credicorp public API from Java
Here is the idiomatic Java way to make your first Credicorp public API call. List the live products from GET /public/v1/products,…
Read →Quickstart: call the Credicorp public API from Kotlin
Here is the idiomatic Kotlin way to make your first Credicorp public API call. List the live products from GET…
Read →Quickstart: call the Credicorp public API from Node.js
Node 18+ ships a global fetch, so you can call the Credicorp public API with zero dependencies. This quickstart lists the live…
Read →Quickstart: call the Credicorp public API from PHP
You can call the Credicorp public API from PHP with the built-in cURL extension and no Composer packages. This quickstart…
Read →Quickstart: call the Credicorp public API from Perl
Here is the idiomatic Perl way to make your first Credicorp public API call. List the live products from GET /public/v1/products,…
Read →Quickstart: call the Credicorp public API from PowerShell
Here is the idiomatic PowerShell way to make your first Credicorp public API call. List the live products from GET…
Read →Quickstart: call the Credicorp public API from Python
With the requests library you can call the Credicorp public API in about ten lines of Python. This quickstart lists the live…
Read →Quickstart: call the Credicorp public API from Ruby
Ruby's standard library calls the Credicorp public API without a gem. This quickstart uses net/http and json to list products,…
Read →Quickstart: call the Credicorp public API from Rust
Here is the idiomatic Rust way to make your first Credicorp public API call. List the live products from GET /public/v1/products,…
Read →Quickstart: call the Credicorp public API from Swift
Here is the idiomatic Swift way to make your first Credicorp public API call. List the live products from GET…
Read →Quickstart: call the Credicorp public API from shell + jq
Here is the idiomatic shell + jq way to make your first Credicorp public API call. List the live products from GET…
Read →Quickstart: call the public API from the browser safely
The public ring sends permissive CORS headers for read endpoints, so you can call it straight from the browser. That is perfect…
Read →Quickstart: choose the right base URL — sandbox vs production
Every Credicorp API integration should read its base host from configuration, never hard-code it. Development and CI point at the…
Read →Quickstart: connect an AI agent to the Credicorp MCP server
POST /public/v1/mcp is a Model Context Protocol endpoint that exposes the public API as agent tools. Point an MCP-capable…
Read →Quickstart: embed a product picker with the public API
A product picker is the simplest high-value embed: fetch the catalogue, render options, link to apply. Because the product list…
Read →Quickstart: fetch a single Credicorp product by id
GET /public/v1/products/{id} returns the full detail for one product. Use it to power a product page after the reader picks an…
Read →Quickstart: fetch published CMS content by key
GET /public/v1/cms/pages/{key} serves published Credicorp content by a stable key. Use it to pull canonical copy — a legal…
Read →Quickstart: fetch the support widget configuration
GET /public/v1/support/widget returns the configuration for the embeddable Credicorp support widget. Read the branding, entry…
Read →Quickstart: get an indicative loan quote from the public API
POST /public/v1/quote turns an amount and term into an illustrative repayment. Send the requested amount and term in months and…
Read →Quickstart: handle Credicorp API error responses
Every Credicorp API error uses the same envelope: { error: { type, code, message, request_id } }. Branch on the stable code, log…
Read →Quickstart: handle rate limits on the public API
The public ring is rate-limited, and a 429 tells you exactly when to try again. Read the RateLimit-Remaining and RateLimit-Reset…
Read →Quickstart: list Credicorp business-finance products
GET /public/v1/products returns the live catalogue of Credicorp business-finance products. Each item carries the amount range,…
Read →Quickstart: list Credicorp loyalty tiers
GET /public/v1/loyalty/tiers returns the public loyalty ladder. Each tier carries a name, the qualifying threshold and its…
Read →Quickstart: paginate through list results with a cursor
Credicorp list endpoints use cursor pagination: follow next_cursor until it is null. Cursor paging is stable under inserts, so…
Read →Quickstart: read live API status programmatically
GET /public/v1/status gives your integration a machine-readable view of API health. Read it to gracefully degrade a non-critical…
Read →Quickstart: read public pricing configuration
GET /public/v1/config/pricing exposes the representative pricing parameters behind the public quote. Use it to show headline…
Read →Quickstart: record marketing and data consent
POST /public/v1/consent records a user's consent choices at the point of collection. Capture the consent alongside an enquiry so…
Read →Quickstart: send a message to the support chat endpoint
POST /public/v1/support/chat powers a conversational support experience. Post the visitor's message with a conversation id and…
Read →Quickstart: set the right request headers for the public API
A handful of request headers make the difference between a clean integration and a flaky one. Always send Accept:…
Read →Quickstart: submit a business-finance enquiry
POST /public/v1/enquiries is how a website or partner hands a lead into Credicorp. Post the company and contact details, and the…
Read →Quickstart: use idempotency keys on write requests
An Idempotency-Key header makes a POST safe to retry. Generate one UUID per logical operation, send it with the write, and reuse…
Read →Quickstart: use the Credicorp public API in AWS Lambda
Here is the idiomatic way to call the Credicorp public API from AWS Lambda. Fetch the product catalogue, cache it, and read the…
Read →Quickstart: use the Credicorp public API in Angular
Here is the idiomatic way to call the Credicorp public API from Angular. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Astro
Here is the idiomatic way to call the Credicorp public API from Astro. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Cloudflare Workers
Here is the idiomatic way to call the Credicorp public API from Cloudflare Workers. Fetch the product catalogue, cache it, and…
Read →Quickstart: use the Credicorp public API in Django
Here is the idiomatic way to call the Credicorp public API from Django. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Express
Here is the idiomatic way to call the Credicorp public API from Express. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in FastAPI
Here is the idiomatic way to call the Credicorp public API from FastAPI. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Flask
Here is the idiomatic way to call the Credicorp public API from Flask. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Laravel
Here is the idiomatic way to call the Credicorp public API from Laravel. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Laravel Livewire
Here is the idiomatic way to call the Credicorp public API from Laravel Livewire. Fetch the product catalogue, cache it, and read…
Read →Quickstart: use the Credicorp public API in Next.js
Here is the idiomatic way to call the Credicorp public API from Next.js. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Nuxt
Here is the idiomatic way to call the Credicorp public API from Nuxt. Fetch the product catalogue, cache it, and read the base…
Read →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…
Read →Quickstart: use the Credicorp public API in Remix
Here is the idiomatic way to call the Credicorp public API from Remix. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Ruby on Rails
Here is the idiomatic way to call the Credicorp public API from Ruby on Rails. Fetch the product catalogue, cache it, and read…
Read →Quickstart: use the Credicorp public API in Spring Boot
Here is the idiomatic way to call the Credicorp public API from Spring Boot. Fetch the product catalogue, cache it, and read the…
Read →Quickstart: use the Credicorp public API in SvelteKit
Here is the idiomatic way to call the Credicorp public API from SvelteKit. Fetch the product catalogue, cache it, and read the…
Read →Quickstart: use the Credicorp public API in Symfony
Here is the idiomatic way to call the Credicorp public API from Symfony. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in Vue 3
Here is the idiomatic way to call the Credicorp public API from Vue 3. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: use the Credicorp public API in WordPress
Here is the idiomatic way to call the Credicorp public API from WordPress. Fetch the product catalogue, cache it, and read the…
Read →Quickstart: use the Credicorp public API in htmx
Here is the idiomatic way to call the Credicorp public API from htmx. Fetch the product catalogue, cache it, and read the base…
Read →Quickstart: verify connectivity with the healthz endpoint
Before you debug an integration, prove you can reach the API at all with GET /public/v1/healthz. It is a tiny, dependency-free…
Read →Quickstart: your first Credicorp public API call with curl
The fastest way to see the Credicorp public API working is a single curl call to GET /public/v1/products. The public ring is…
Read →Quote a Business Loan with the Node SDK
The Node SDK exposes the public quote endpoint as a typed async call. Await a quote for an amount and term; a range error throws…
Read →Quote a Business Loan with the PHP SDK
The PHP SDK wraps the public quote endpoint so you fetch a live figure in three lines. It handles the HTTP, the JSON and the…
Read →Quote a Business Loan with the Python SDK
The Python SDK wraps the public quote endpoint. Construct the client, call quote.one_time(...) with an amount and term, and catch…
Read →Read and render the loyalty ladder
Render the loyalty ladder from the public loyalty/tiers endpoint (or the MCP loyalty_tiers tool). It carries tier names,…
Read →Read the error envelope
Every failure tells you exactly what went wrong — if you read the envelope. type gives the class, code the specific reason,…
Read →Receive your first webhook
Go from nothing to a verified webhook in four steps: expose an HTTPS endpoint, register it, verify the Credicorp-Signature, and…
Read →Record cookie consent from your edge
Record a visitor’s cookie choices to the consent endpoint from your server, not the browser. When someone interacts with your…
Read →Render a live Business Loan quote widget
Wire a small front-end control to the public quote endpoint so visitors get a live, accurate Business Loan figure. Clamp inputs…
Read →Render the loyalty ladder on your site
Show the Credicorp loyalty ladder on any page from one cached call. Fetch the four tiers, render them Bronze→Platinum, and…
Read →Replay and recover missed webhooks
If your endpoint was down, you have options. Automatic retries cover a 72-hour window, you can manually redeliver specific…
Read →Respond to a 401 cleanly
A partner 401 has two causes: an expired token (re-mint and retry once) or an invalid credential (fix it — do not loop). Telling…
Read →Retry a write safely with an idempotency key
A retried write is dangerous without an idempotency key. If the first request succeeded before the connection dropped, a naive…
Read →Rotate a webhook signing secret
Rotate the signing secret if it may have leaked — with no downtime. Rotation issues a new whsec_ secret while the old one stays…
Read →Rotate partner API credentials with zero downtime
Rotate a partner secret with no outage: create a second credential with the same scopes, cut traffic to it, verify, then revoke…
Read →Route enquiries to the right department
Send each enquiry to the right team with the dept field. Set dept to support, payments, hardship or complaints and the enquiry is…
Read →Route webhook events by type
One endpoint, many event types. Dispatch on the envelope type to a small handler per event, and no-op anything you do not…
Read →Secure a webhook endpoint
A webhook endpoint is an inbound door — lock it. Enforce HTTPS, verify every signature over the raw body, reject stale timestamps…
Read →Set up a webhook endpoint
A production webhook endpoint needs five things: a public HTTPS URL, signature verification, a fast 2xx, async processing, and…
Read →Smoke-test the public API in 60 seconds
Confirm the public ring works before you build: three unauthenticated curls — healthz, products, quote — prove reachability, the…
Read →Submit a contact form to the enquiries endpoint
Wire any contact form to POST /public/v1/enquiries in a few lines. Collect the visitor’s answers into a flat fields object, set…
Read →Submit an application on partner/v1
Take an application end to end on the partner ring: mint a token, POST /applications with an idempotency key, then read the…
Read →Test a webhook locally with a tunnel
Test webhooks against local code without deploying. Expose your local server through a tunnel, register the tunnel URL as a…
Read →Troubleshoot webhook signature failures
Signature verification fails for four reasons, and only four. You verified against a parsed body instead of the raw bytes, used…
Read →Validate inputs before you post
Catch validation errors before the API does. The public ring enforces strict input rules server-side, but mirroring them in your…
Read →Verify a partner token locally with the JWKS
Verify a partner JWT yourself instead of calling introspection every time: fetch the JWKS, cache by kid, and validate signature,…
Read →Verify a webhook signature
Never trust an unverified webhook. Recompute the signature over the raw request body with your endpoint secret and compare in…
Read →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.