Defacto's Receivable financing API enables SMB platforms to offer immediate invoice payments to borrowers
Overview
This guide explains how to integrate Defacto's Receivable financing product into your platform. It enables your users (borrowers) to get paid upfront for invoices while their B2B customers benefit from flexible payment terms. It's ideal for solving cash flow issues caused by payment delays.
If you're a marketplace, the borrower is typically the seller on your platform.
Onboard your user as a borrower
Create a borrower with only a company registration number
Parameters: The company's registration number (e.g., SIREN in France, NIF in Spain).
Why it matters
- Required for legal verification and underwriting.
FAQ
- Why is the legal identifier mandatory?
Because it uniquely identifies the company and allows us to retrieve financial and legal data for eligibility and risk assessment. - What countries are supported?
We currently support France, Spain, Germany, Netherlands & Belgium
T&Cs acceptation
➡️ POST /borrower/{borrower_id}/sign
Description: Inform Defacto that the borrower has accepted the terms and conditions.
Parameters: signed_at
(required): The date and time when the T&Cs were accepted.
FAQ
- Does Defacto provide standard T&Cs?
Yes, we provide T&Cs tailored to each country’s legal framework and available in multiple languages. - When are contracts generated and shared with the borrower?
Contracts are generated once a loan is approved and available via API or email.
Enable a repayment method
SEPA Direct Debit (SDD)
Defacto will debit your borrower directly. You'll need:
- IBAN & BIC
- Business email
- Legal rep’s birthdate, nationality & country of residence
SEPA Credit Transfer (SCT)
If you prefer to handle repayments:
- You transfer funds to Defacto
- Or provide the wallet IBAN for us to debit
FAQ
- What method fits my use case best?
Use SDD for automated repayment. Use SCT if you prefer to control cash flow manually or already have repayment collection in place. - Can repayment responsibility change later?
Yes, repayment method can be updated anytime as long as it aligns with contract terms.
Show "Cash in now" only to eligible users
Check the borrower's credit line
Once the borrower is onboarded and signed, Defacto creates a credit line.
FAQ
- What is a credit line?
It's the maximum total amount the borrower can use at any given time. - How is the credit line amount calculated?
Based on real-time financial and transactional data, including revenue, payment history, and risk profile. - Can we share additional data to increase limits?
Yes. The more data you provide (e.g. sales history, accounting data), the more accurate and potentially higher the limit.
Request a loan when invoice is selected
Trigger the loan request
➡️ POST /loans
Required fields:
loan_type
:INVOICE_BASED_FINANCING
to_account
: Usually same as invoiceto_pay_at
: Set to todayloan_to
: Borrower’s bank account or walletto_repay_at
: Any date between 1–120 daysauto_validate
: Set totrue
for better UXsalt_id
: Unique ID to avoid duplicates
Check loan payment status
➡️ GET /payments?loan_id=<LOAN_ID>
FAQ
- Can a loan be smaller than the invoice amount?
Yes, you can finance a partial amount of the invoice depending on the borrower's needs or eligibility. - Why might a loan request be rejected?
Common reasons: expired credit line, poor financial metrics, duplicate request, or missing data.
Repayment
Available options
- SDD: Defacto debits the borrower
- SCT: You or the borrower transfer funds to Defacto
No API call is needed for reconciliation.
Get repayment details
Returns:
- Virtual IBAN for repayment
- Reference to attach to transfer
Modify repayment date
You can update the repayment date (max 120 days).
SDD timing: Takes 3 working days.
FAQ
- What happens if repayment is late?
Interest continues to accrue daily. We may trigger additional collection processes or block further financing until repayment is completed.
Billing
Check monthly billing info
Billing is based on the outstanding loan amount and the number of days it’s been active. Interest stops accruing as soon as a loan is repaid.
Our fees explained
- Interest is not subject to VAT
- Daily interest rate: 0.05%
- Formula:
Interest = 0.05% × Loan amount × Days borrowed
- You pay only for what’s used
At the beginning of each month, we bill the total accrued interest from all active loans.
Billing follows the repayment flow:
- If Defacto handles repayment, we bill the borrower and debit directly
- If you handle repayment, you pay the fees
FAQ
- How do we reconcile billing and repayments?
Defacto handles reconciliation automatically. You can cross-check repayments and bills via the/bills
and/loans
endpoints. - Can fees be passed on to the borrower automatically?
Yes, this can be configured contractually. Fees can either be charged directly or transferred to the borrower.