API Reference

Payable financing x Platforms

Defacto's payable financing API enables SMB platforms to offer buy now pay later capabilities (B2B BNPL)

Overview

This guide explains how to integrate Defacto's "Payable Financing" product into your platform. It allows your users (borrowers) to defer payments to suppliers—ideal for managing cash flow, stock financing, and other B2B purchases.

If you're a marketplace, the borrower is typically the buyer 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).

FAQ

  • Why is the legal identifier mandatory?
    It’s needed to verify company data, assess risk, and ensure regulatory compliance.
  • What countries are supported?
    We currently support France, Spain, Germany, Netherlands & Belgium

T&Cs acceptation

➡️ POST /borrower/{borrower_id}/sign

Tell Defacto your user accepted our terms and conditions by passing the signed_at parameter.

FAQ

  • Does Defacto provide terms and conditions?
    Yes, in multiple languages depending on the country.
  • When are contracts generated?
    At loan approval. They’re accessible by API or sent via email.

Choose repayment method

SEPA Direct Debit (SDD)
To enable Defacto to collect repayments automatically, provide:

  • IBAN and BIC
  • Business email
  • Legal rep’s birthdate, country of residence, nationality

SEPA Credit Transfer (SCT)
If you collect repayments, you can:

  • Transfer repayments to Defacto
  • Or let Defacto debit a dedicated wallet

FAQ

  • Can I change repayment method later?
    Yes, repayment methods can be updated anytime as long as they respect loan terms.

KYB / KYC compliance

Loans are only approved once KYB is marked APPROVED. You can check status via:
➡️ GET /borrower/{id} → compliance_checks field

FAQ

  • What happens if KYB isn’t approved?
    Loan request is paused until review is complete.

Provide "Pay Later" for eligible users

Check credit line eligibility

➡️ GET /credit_lines

We automatically create a line of credit when onboarding is complete.

Best practice
Only request loans if:

  • Credit line > 0
  • Compliance is approved
  • Credit line matches your average cart (e.g. ≥ 1,000 €)

FAQ

  • How is the credit limit calculated?
    Based on financial and transactional data.
  • Can we influence the limit?
    Yes—share accounting, payment, and platform activity data with us.

Request a loan

➡️ POST /loans

Required fields:

  • loan_type: INVOICE_BASED_FINANCING
  • to_account: Usually matches invoice account
  • to_pay_at: Today
  • loan_to: Supplier bank account
  • to_repay_at: Typically 30, 60, or 90 days
  • auto_validate: Set to true for better UX
  • salt_id: Unique ID to avoid duplicates

FAQ

  • Can the loan be smaller than the invoice?
    Yes, partial financing is supported.
  • Why might a loan be rejected?
    Common reasons: insufficient credit, expired compliance, duplicate request, missing data.

➡️ GET /payments?loan_id=<LOAN_ID>
To check loan disbursement status.

Repayment

Options

  • SDD: Defacto collects funds automatically
  • SCT: You transfer repayment to Defacto

➡️ GET /loan/{loan_id} to get:

  • Repayment IBAN
  • Transfer reference

➡️ PATCH /loan/{loan_id} to modify the repayment date once (max 30 days later)

FAQ

  • What if the repayment is late?
    Interest continues accruing daily. Further financing may be suspended.

Billing

➡️ GET /bills

Billing is calculated monthly on the outstanding amount:

  • Daily interest rate: 0.05%
  • Stops accruing once the loan is repaid

Formula:
Interest = 0.05% × Amount × Days

FAQ

  • Who gets the bill?
    If Defacto handles repayment, we bill the borrower directly. Otherwise, you’re responsible.
  • Can I pass fees to my users?
    Yes—this can be defined contractually.