Documentation index for AI agents (llms.txt)

Append .md to any page URL for its markdown source, or fetch llms-full.txt for the complete corpus.

Offer selection

Offer selection overview

Selecting offers for customer draw down

BROKER ONLY INTEGRATIONS. This endpoint is for broker and hybrid integrations, where iwoca contacts the broker rather than the customer. If you're building a decision-relayed integration, don't call it – redirect the customer with GET /customers/{customer_id}/login_link/ instead, passing their chosen offer as offer_id.

Confirm which offer a customer wants to go ahead with. This tells iwoca to prepare for draw down on the selected terms. You can only select one offer per application.

Essentials

  1. 1
    Select the offer

    Call POST /offers/{offer_id}/select/ with the customer's chosen offer. This tells iwoca to go ahead.

  2. 2
    Hand the customer over

    Pass "entity_to_contact": "customer" in the request body when you want iwoca to take over contact with the customer from here.

  3. 3
    Redirect the customer

    When contact entity is set to customer, the response includes a login_url. Redirect the customer there to complete draw down.

Reference