# (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.

Endpoint: POST /v1/businesses/{business_id}/fronting_loans/{loan_id}/payouts
Version: 1.0

## Path parameters:

  - `business_id` (string, required)
    The ID of the business that applied for the fronting factoring.

  - `loan_id` (string, required)
    The ID of the loan for which a partial payout is made.

## Request fields (application/json):

  - `transaction_description` (string, required)
    The transaction reference, which the recipient will see. Only use characters allowed by SEPA in this field.
    Example: "Example transaction."

  - `transaction_end_to_end_id` (string, 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: "DDHHDHG333243"

  - `recipient_iban` (string, required)
    The IBAN of the recipient of the loan payout.
    Example: "DE15100100100003404109"

  - `recipient_name` (string, required)
    The name of the recipient of the loan payout.
    Example: "Daniel Schmidt"

  - `amount` (object, required)
    The amount of the partial loan payout.
    Example: {"currency":"EUR","unit":"cents","value":1000}

  - `amount.value` (integer, required)
    The amount value
    Example: 1000

  - `amount.currency` (string, required)
    The currency of the given value. Only EURO is currently supported.
    Example: "EUR"

  - `amount.unit` (string, required)
    The unit of the given value.
    Enum: "cents"

  - `tag` (string)
    The type of the partial loan payout related to a fronting factoring transaction.
    Enum: "INITIAL_PAYOUT", "RETENTION_FEE", "FACTORING_INTEREST", "VAT_TRANSFER"

## Response 201 fields (application/json):

  - `id` (string, required)
    The unique ID of a business fronting loan's payout.
    Example: "963347398e47416c9df216a63ef035c2bflp"

  - `loan_id` (string, required)
    The unique ID of the business fronting loan.
    Example: "29e1a05906954ce082ec779d81de8c1ebflo"

  - `recipient_iban` (string, required)
    The IBAN of the loan payout's recipient.
    Example: "DE92370601930002130041"

  - `recipient_name` (string, required)
    The name of the loan payout's recipient.
    Example: "Max Mustermann"

  - `tag` (string, required)
    The tag of the business fronting loan's payout.
    Enum: "INITIAL_PAYOUT", "RETENTION_FEE", "FACTORING_INTEREST"

  - `status` (string, required)
    The status of the business fronting loan's payout.
    Enum: "transfers_pending", "transfers_complete"

  - `amount` (object, required)
    The amount of the loan payout.
    Example: {"currency":"EUR","unit":"cents","value":1000}

  - `amount.value` (integer, required)
    The amount value
    Example: 1000

  - `amount.currency` (string, required)
    The currency of the given value. Only EURO is currently supported.
    Example: "EUR"

  - `amount.unit` (string, required)
    The unit of the given value.
    Enum: "cents"

  - `transaction_description` (string,null)
    The transaction reference, which the recipient will see. Only use characters allowed by SEPA in this field.
    Example: "Example transaction."

  - `transaction_end_to_end_id` (string,null)
    SEPA identifier (provided by the end customer who initiated the SEPA transaction), routed through the whole payment process. (Max 35 characters without whitespace)
    Example: "DDHHDHG333243"

## Response 400 fields (application/json):

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `detail` (string)
    Example: "Cannot connect to database."

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `title` (string)
    Example: "Failed to build pagination headers."

## Response 403 fields (application/json):

  - `code` (string)
    Example: "unauthorized_action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `title` (string)
    Example: "Unauthorized Action"

## Response 404 fields (application/json):

  - `code` (string)
    Example: "model_not_found"

  - `detail` (string)
    Example: "Couldn't find 'Account' for id 'DE24112233445566'."

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `title` (string)
    Example: "Model Not Found"