Skip to content
Webhooks
/
/
INCOMING_REJECTED_TRANSAC...

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

FREELANCER_OVERDRAFT_INTEREST_RATE_CHANGEWebhook

Request

The overdraft's interest_accrual_rate has been recalculated and updated due to a reference rate change.

Bodyapplication/json
idstringrequired

The ID of the overdraft.

interest_accrual_ratenumber(float)required

The new daily rate at which interest is accrued on the used amount of the overdraft.

effective_fromstring(date-time)required

The date and time in which the new interest accrual rate becomes effective.

application/json
{
  "id": "string",
  "interest_accrual_rate": 0.1,
  "effective_from": "2019-08-24T14:15:22Z"
}

Responses

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

INCOMING_REJECTED_TRANSACTIONWebhook

Request

An incoming transaction to an account was rejected. This webhook is relevant for Restricted Accounts, Decoupled Cards, and Credit Cards. The webhook payload will differ depending on the product.

Bodyapplication/json
One of:

Webhook payload for Decoupled and Credit Cards.

statusstring

The current status of the transaction.

Example: "RETURNED"
status_reasonstring

The reason why the transaction was rejected.

Example: "The debtor name is not matching"
sender_namestring

The name of the person who sent the funds.

Example: "John Mustermann"
sender_ibanstring

IBAN of the account from which the funds were sent.

Example: "DE32110101001000000029"
person_idstring

ID of the person who owns the restricted account.

Example: "c77044e6a8e35e3a4deaf7c9a4cc2476cper"
business_idstring

ID of the business who owns the restricted account.

Example: "567eaf2b22fce21a1920e14e11e2bfa3cbiz"
account_idstring

ID of the restricted account.

Example: "c61ca1f2fbf12830517ae2fce6e2cd79cacc"
application/json
{
  "status": "RETURNED",
  "status_reason": "The debtor name is not matching",
  "sender_name": "John Mustermann",
  "sender_iban": "DE32110101001000000029",
  "person_id": "c77044e6a8e35e3a4deaf7c9a4cc2476cper",
  "business_id": "567eaf2b22fce21a1920e14e11e2bfa3cbiz",
  "account_id": "c61ca1f2fbf12830517ae2fce6e2cd79cacc"
}

Responses

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

IDENTIFICATIONWebhook

Request

A person identification was created, or its status was updated. The primary purpose of this webhook is to deliver the URL where the customer must be redirected to complete a video identification.

Bodyapplication/json
idstring

ID of the person identification.

Example: "9dfe2f4edaa67138be0c0c1cd3a7d849cidt"
referencestring

Reference generated by the identification provider.

Example: "TST-ELCCJ"
urlstring

(IDnow only) Redirect URL used to start the identification process.

Example: "https://go.test.idnow.de/"
statusstring

The current status of the identification. Note The status value depends on the identification method, check the KYC guides for more information.

Enum"aborted""authorization_required""confirmation_required""confirmed""created""canceled""expired""failed""identification_data_required""pending"
Example: "successful"
completed_atstring

Date and time when the identification was completed.

Example: "2021-09-14T18:18:28.000Z"
methodstring

The method used for the identification.

Enum"bank""bank_id""bank_plus""fourthline""idnow""idnow_autoident""manual""postident"
Example: "idnow"
metadataobject
application/json
{
  "id": "9dfe2f4edaa67138be0c0c1cd3a7d849cidt",
  "reference": "TST-ELCCJ",
  "url": "https://go.test.idnow.de/",
  "status": "successful",
  "completed_at": "2021-09-14T18:18:28.000Z",
  "method": "idnow",
  "metadata": {
    "account_bic": "SOBKDEB2XXX",
    "account_currency": "EUR",
    "account_id": "string",
    "iban": "string"
  }
}

Responses

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