Receivable financing x Platforms

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

➡️ POST /borrowers

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

➡️ GET /credit_lines

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 invoice
  • to_pay_at: Set to today
  • loan_to: Borrower’s bank account or wallet
  • to_repay_at: Any date between 1–120 days
  • auto_validate: Set to true for better UX
  • salt_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

➡️ GET /loan/{loan_id}

Returns:

  • Virtual IBAN for repayment
  • Reference to attach to transfer

Modify repayment date

➡️ PATCH /loan/{loan_id}

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

➡️ GET /bills

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.