Quickstart: Credicorp public API for a B2B marketplace

Finance at the point of need

At basket or invoice stage, quote the order value with the quote endpoint and show 'spread this cost' with a real monthly figure.

Hand the buyer off

Submit an enquiry with the order context and redirect to the handoff_url. Credicorp lends to the buyer's limited company, keeping your marketplace out of the credit relationship.

async function financeOrder(order) {
  const res = await fetch(`${BASE}/enquiries`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'Idempotency-Key': order.id },
    body: JSON.stringify({
      company: { name: order.buyer.companyName, number: order.buyer.companyNumber },
      contact: { email: order.buyer.email },
      amount: order.total,
      purpose: 'stock_purchase',
    }),
  });
  const { handoff_url } = await res.json();
  window.location.href = handoff_url;
}

Place it at the right moment

Timing decides conversion. Surface the option where the buyer feels the cost — at basket review, on the invoice, or on an order-confirmation screen for a repeat purchase — not on a generic footer. Pre-fill the amount from the order total so the quote is instantly relevant, and pass the marketplace order id as the idempotency key so a retried checkout never creates a duplicate enquiry.

Stay out of the credit chain

Your marketplace introduces the buyer; Credicorp underwrites and lends to the buyer's limited company directly. That keeps you clear of the regulated credit relationship while still adding a genuinely useful funding option. For revenue share and settlement callbacks, onboard to the partner ring.