Partner API FAQ

This page will host frequently asked questions for Partner API integrations.

For immediate support, email partners@finmatch.io.

Which statuses will I receive?

Match on credit_application_status. It is the lender's raw code as a string, for example "CONDITIONALLY_APPROVED". See Zopa statuses and Propensio statuses. Lenders can send statuses that are not on those lists.

Can I get the final loan amount?

Notifications carry loan_amount as a two-decimal string when the lender sends it. For Zopa, loan_amount is also purchase price minus deposit when both are present and numeric. Otherwise null. We do not send a drawn-down figure.

What happens if my endpoint is down?

We retry every notification for about 24 hours. If your endpoint was down for longer, tell us when, and we replay every event from that period with the same event_id, so your duplicate check still works.

What if I don't send merchant_reference?

You still receive every notification, with finmatch_reference. merchant_reference is null.

Can one API key be used for several of my clients?

No. Each partner account has its own key and its own linked merchants, and you only receive notifications for merchants that have agreed to share application statuses with you.