Skip to content
Webhooks
/
/
LEGAL_REPRESENTATIVE

Webhooks (1.0)

Download OpenAPI description
webhooks.json
webhooks.yaml
Languages
Servers
Mock Server

https://docs.solarisgroup.com/_mock/api-reference/onboarding/webhooks/

Webhook subscription

Operations

Webhook events

Webhooks

INSTANT_SEPA_CREDIT_TRANSFER_FAILEDWebhook

Request

An outgoing SEPA Instant Credit Transfer has failed and has not been booked on the account.

Bodyapplication/json
idstring<= 35 characters

The ID of the transaction.

Example: "e8308bd66d3472a987d262d05fb5098siot"
amountobject

The transaction amount.

Example: {"value":3000,"currency":"EUR"}
creditor_ibanstring

The IBAN of the creditor account (i.e., the account holder receiving the money). The IBAN must be reachable via SCT Instant!

Example: "Lisa Herrmann"
creditor_namestring<= 70 characters

The name of the creditor (i.e., account holder).

Example: "DE02500105170137075030"
descriptionstring<= 140 characters

A description for the transaction given by the customer.

Example: "Geschenk"
end_to_end_idstring<= 35 characters

Your unique end-to-end ID for the transaction.

Example: "e2178fc8b9ad4a479e269a47f90b4a43"
statusstring

The status of the Instant SCT. Only possible value is FAILED.

Example: "FAILED"
valuta_datestring(date)

The valuta date of the transaction.

Example: "2022-04-22"
account_idstring

The ID of the account associated with the instant SCT.

Example: "adc123a45d6d7cf8fbfeed537ba919d5cacc"
account_ibanstring

The IBAN of the account associated with the instant SCT.

Example: "DE87110101001000057123"
rejection_reasonstring

Reason why the transaction failed.

Example: "IBAN not reachable"
schedule_idstring

Unique ID of the schedule transfer.

Example: "f874b3102718a4d757a6b6e4d599607csctr"
batch_idstring

Unique ID of the batch.

Example: "f874b3102718a4d757a6b6e4d5996078sctb"
application/json
{
  "id": "e8308bd66d3472a987d262d05fb5098siot",
  "amount": {
    "value": 3000,
    "currency": "EUR"
  },
  "creditor_iban": "Lisa Herrmann",
  "creditor_name": "DE02500105170137075030",
  "description": "Geschenk",
  "end_to_end_id": "e2178fc8b9ad4a479e269a47f90b4a43",
  "initiator_reference": "2603037c-e264-46c4-82e8-0d3ebc23a30f",
  "idempotency_key": "7352a11b-011d-47a4-a449-17371078e98c",
  "status": "FAILED",
  "valuta_date": "2022-04-22",
  "account_id": "adc123a45d6d7cf8fbfeed537ba919d5cacc",
  "account_iban": "DE87110101001000057123",
  "rejection_reason": "IBAN not reachable",
  "schedule_id": "f874b3102718a4d757a6b6e4d599607csctr",
  "batch_id": "f874b3102718a4d757a6b6e4d5996078sctb"
}

Responses

Return 200 to indicate that you successfully received the webhook notification.

LEGAL_REPRESENTATIVEWebhook

Request

A legal representative was linked to, or unlinked from, a business. Solaris will send notifications on this webhook if more legal representatives are discovered during the business identification process.

Bodyapplication/json
idstring

ID of the legal representative relationship.

Example: "a46578f4049f42aba9fe88a2a80fed53"
legal_representative_idstring

ID of the person or business with the legal authority to represent the business.

Example: "33fbdd2c0bb94db1af5b5d2a4426cper"
legal_representative_typestring

The type of legal representative that this record represents.

Enum"Person""Business"
Example: "Person"
valid_untilstring

Date when the legal representative relationship expires.

Example: "2022-12-31"
business_idstring

ID of the business for which the person or business is a legal representative.

Example: "095cc43012a04ccca02f0f93c145cbiz"
application/json
{
  "id": "a46578f4049f42aba9fe88a2a80fed53",
  "legal_representative_id": "33fbdd2c0bb94db1af5b5d2a4426cper",
  "legal_representative_type": "Person",
  "valid_until": "2022-12-31",
  "business_id": "095cc43012a04ccca02f0f93c145cbiz"
}

Responses

Return 200 to indicate that you successfully received the webhook notification.

LOANWebhook

Request

The status of a customer's loan has changed. Please note that webhook payload is returned as a JSON-encoded string.

Bodyapplication/json
payloadobject

An object containing the webhook payload.

event_typestring

The webhook event name.

Example: "LOAN"
entity_uuidstring

The resource ID of the loan.

Example: "82d78c39956645ffbd59c51cdb63f7b0cloa"
application/json
{
  "payload": {
    "total_loan_expenses": { … },
    "term": 24,
    "status_reason": "upfront_subsidy_pull_failed_collateral_account_not_set",
    "status": "payout_issued",
    "repayment_plan_updated_at": "2021-04-16T13:52:05Z",
    "repayment_plan_created_at": "2020-04-16T13:52:05Z",
    "repayment_begin_date": "2020-05-16",
    "reference": "string",
    "recipient_iban": "DE88888881010987654321",
    "purpose": "Buying a car.",
    "person_id": "547a870b2c8461a3104559369d09265dcper",
    "payout_date": "2020-05-16",
    "overdue_amount": { … },
    "monthly_payment": { … },
    "maturity_date": "2022-05-16",
    "loan_account_id": "adc123a45d6d7cf8fbfeed537ba919d5cacc",
    "loan_account_iban": "DE72110101014351836685",
    "interest_start_date": "2021-06-16",
    "interest_rate": 0.0499,
    "id": "c13447d659db4cdcb450b977f8f25c57cloa",
    "effective_interest_rate": 0.0511,
    "created_at": "2021-06-16T10:22:38",
    "billing_account_id": "1d0e52af0a62b4b44d8c54a87a7fc6a7cacc",
    "billing_account_iban": "DE72110101014351836685",
    "annual_percentage_rate": 0,
    "amount": { … }
  },
  "event_type": "LOAN",
  "entity_uuid": "82d78c39956645ffbd59c51cdb63f7b0cloa"
}

Responses

Return 200 to indicate that you successfully received the webhook notification.