Business fronting

(Factoring only) Trigger a partial loan payout for a business fronting factoring

Triggers a partial loan payout related to a business fronting factoring application. The loan payout is used to purchase receivables in multiple partial payouts. You must add the required transaction details in the request body.

post/v1/businesses/{business_id}/fronting_loans/{loan_id}/payouts

Path parameters

business_idstring required

The ID of the business that applied for the fronting factoring.

loan_idstring required

The ID of the loan for which a partial payout is made.

Request body

recipient_ibanstring required

The IBAN of the recipient of the loan payout.

recipient_namestring required

The name of the recipient of the loan payout.

tag'INITIAL_PAYOUT' | 'RETENTION_FEE' | 'FACTORING_INTEREST' | 'VAT_TRANSFER'

The type of the partial loan payout related to a fronting factoring transaction.

transaction_descriptionstring required

The transaction reference, which the recipient will see. Only use characters allowed by SEPA in this field.

transaction_end_to_end_idstring required

SEPA identifier (provided by the end customer who initiated the SEPA transaction), routed through the whole payment process. (Max 35 characters without whitespace).

Example request

{
  "amount": {
    "currency": "EUR",
    "unit": "cents",
    "value": 1000
  },
  "recipient_iban": "DE15100100100003404109",
  "recipient_name": "Daniel Schmidt",
  "tag": "INITIAL_PAYOUT",
  "transaction_description": "Example transaction.",
  "transaction_end_to_end_id": "DDHHDHG333243"
}

Response

Payout

idstring required

The unique ID of a business fronting loan's payout.

loan_idstring required

The unique ID of the business fronting loan.

recipient_ibanstring required

The IBAN of the loan payout's recipient.

recipient_namestring required

The name of the loan payout's recipient.

status'transfers_pending' | 'transfers_complete' required

The status of the business fronting loan's payout.

tag'INITIAL_PAYOUT' | 'RETENTION_FEE' | 'FACTORING_INTEREST' required

The tag of the business fronting loan's payout.

transaction_descriptionstring nullable

The transaction reference, which the recipient will see. Only use characters allowed by SEPA in this field.

transaction_end_to_end_idstring nullable

SEPA identifier (provided by the end customer who initiated the SEPA transaction), routed through the whole payment process. (Max 35 characters without whitespace)

Example response

{
  "amount": {
    "currency": "EUR",
    "unit": "cents",
    "value": 1000
  },
  "id": "963347398e47416c9df216a63ef035c2bflp",
  "loan_id": "29e1a05906954ce082ec779d81de8c1ebflo",
  "recipient_iban": "DE92370601930002130041",
  "recipient_name": "Max Mustermann",
  "status": "transfers_pending",
  "tag": "INITIAL_PAYOUT",
  "transaction_description": "Example transaction.",
  "transaction_end_to_end_id": "DDHHDHG333243"
}