2 min read
Why the public ring has no webhooks
Webhooks push account-specific events — a decision, a payment — to your server. Those events belong to an authenticated relationship, so they are delivered on the partner ring, not the anonymous public ring.
What to do on the public ring
For public-ring integrations you drive the interaction: submit an enquiry and follow the handoff_url. If you need event callbacks, that is the signal to onboard to the partner programme.
Polling as a stopgap
Where you only need to know whether reference data changed, poll politely with conditional requests rather than expecting a push.
Frequently asked questions
Can I get a webhook when an enquiry converts?
Not on the public ring. Conversion and decision events are delivered on the partner ring, which requires onboarding and authentication.
How do I move to the partner ring?
Apply through the partner programme documented on the developer portal. It gives you OAuth2 credentials, webhooks and the write endpoints.
Related reading
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…
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…
Read →
Quickstart: handle Credicorp API error responses
Every Credicorp API error uses the same envelope: { error: { type, code, message, request_id } }. Branch on…
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…
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.