Welkom bij de Prets Merchant API. Deze API stelt je in staat om eenvoudig dossiers aan te maken en klanten veilig door te sturen naar de Prets-omgeving, waar zij hun financieringsopties kunnen ontdekken.

🔐 1. Toegang en authenticatie

Om de API te gebruiken ontvang je van Prets:

• Een API Key (voor authenticatie)
• Een Merchant name (identificatie van jouw organisatie)

📂 2. Dossier aanmaken

Gebruik het endpoint POST /api/merchant/v1/dossiers om een nieuw dossier aan te maken. Je krijgt een dossier id en een url terug.

Response voorbeeld

{
  "id": "dossier_12345",
  "url": "https://<merchant>.app.prets.io/dossier_12345"
}

Gebruik van de url

• De url leidt de consument direct naar de Prets omgeving.
• De link is eenmalig geldig zonder login.
• Als de link opnieuw wordt gebruikt, kan de consument passwordless inloggen via e-mail.
• Indien nodig, genereer een nieuw dossier.

<aside> ↗️

Link naar API endpoints https://merchant-api.prd.app.prets.io/api/merchant/docs/index.html

</aside>

✅ 3. Best practices