API Reference

Differed Debit x platforms

For fintechs & PSP who want to embed differed debit directly within their cards

Overview

This guide explains how to integrate Defacto's "Differed Debit" product into your platform. It allows you to offer semi-differed debit experiences by powering your users' wallets with credit—ideal for PSPs and fintechs. Loans have a maximum maturity of 45 days and do not require invoices.

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, Germany, Spain, Netherlands, and 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 credit for eligible users

Check credit line eligibility

➡️ GET /credit_lines

We automatically create a line of credit once onboarding and T&Cs are complete.

Best practice
Only request loans if:

  • Credit line > 0
  • Compliance is approved

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: WALLET_FINANCING
  • loan_to: Borrower’s bank account (must belong to the borrower)
  • to_pay_at: Today
  • to_repay_at: Up to 45 days max
  • auto_validate: Set to true for better UX
  • salt_id: Unique ID to avoid duplicates

FAQ

  • Can we send funds to third parties?
    No. WALLET_FINANCING only allows transfers to accounts owned by the borrower.
  • Why might a loan be rejected?
    Common reasons: expired credit line, compliance not approved, or duplicate requests.

➡️ 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 (max 45 days).

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.