Skip to content

Webhooks (1.0)

Download OpenAPI description
Languages
Servers
Mock Server
https://docs.solarisgroup.com/_mock/api-reference/onboarding/webhooks/

Webhook subscription

Operations

Webhook events

Webhooks

DELEGATE_SCA_CANCELWebhook

Request

A customer has declined the authentication process for a 3DS transaction. After receiving this webhook notification, you can stop showing the authentication screen to the customer. Note: This webhook event is only relevant for the old 3DS flow, which will be deprecated. The new 3DS flow using change request does not make use of this webhook.

Bodyapplication/json
amountobject

The transaction's amount.

merchantobject

The merchant related to the transaction.

challenged_atstring(datetime)

UTC timestamp from when the 3DS challenge was presented to the customer.

Example: "2022-11-07T13:34:27+00:00"
expires_atstring(datetime)

UTC timestamp when the 3DS challenge was expired.

Example: "2022-11-07T13:39:27+00:00"
person_idstring

The person ID of the customer who initiated the 3DS transaction.

Example: "682a85d7e490c1360f6c2be2f1addd57cper"
card_idstring

The ID of the card that was used for the 3DS transaction.

Example: "03bafc5569a53a62dd02ad2e5a789b80mcrd"
authenticate_change_request_idstring

The authorization change request ID.

Example: "bbcafe6e9cc66a4aebaa907cea325435csc"
decline_change_request_idstring

The decline change request ID.

Example: "6fbb54aebc42e2c5d4dc881d5cf566d6csc"
channelstring

The channel that was used for the 3DS transaction.

Example: "browser"
application/json
{ "amount": { "value": 1000, "unit": "cents", "currency": "EUR" }, "merchant": { "name": "MCDONALDS 1435", "country": "DE", "url": "https://mcdonalds.de" }, "challenged_at": "2022-11-07T13:34:27+00:00", "expires_at": "2022-11-07T13:39:27+00:00", "person_id": "682a85d7e490c1360f6c2be2f1addd57cper", "card_id": "03bafc5569a53a62dd02ad2e5a789b80mcrd", "authenticate_change_request_id": "bbcafe6e9cc66a4aebaa907cea325435csc", "decline_change_request_id": "6fbb54aebc42e2c5d4dc881d5cf566d6csc", "channel": "browser" }

Responses

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

DEPOSIT_ACCOUNT_UPDATEDWebhook

Request

The status of a mapping between a customer's main (current) account and a savings account has changed.

Bodyapplication/json
idstring

ID of the mapping between the main account and the savings account.

Example: "13bc0b9d-3321-4bac-84ce-1b300a137d88"
statusstring(DepositStatus)

The current status of the savings account.

Enum"OPENED""TAX_REGISTERED""ACTIVE""INACTIVE""FAILED"
deposit_typestring(DepositTypes)

The account type.

Value"SAVINGS_ACCOUNT"
deposit_account_idstring

ID of the savings account.

Example: "e48c29b85992b8772eb7ddd518490920cacc"
main_account_idstring(MainAccount)

ID of the main account.

Example: "148c29b85992b8772eb7ddd518490110cacc"
main_account_ibanstring

IBAN of the external or internal main account.
main_account_iban is conditionally required when the main account is external.

Example: "DE17110101000000000042"
secondary_mappingsArray of strings

IBAN of the seconday mapped accounts

Example: [["DE40010101002231021978","DE40010101002231021979"]]
updated_atstring

UTC timestamp from when the mapping status was updated.

Example: "2024-04-06T09:03:05.321+00:00"
application/json
{ "id": "13bc0b9d-3321-4bac-84ce-1b300a137d88", "status": "OPENED", "deposit_type": "SAVINGS_ACCOUNT", "deposit_account_id": "e48c29b85992b8772eb7ddd518490920cacc", "main_account_id": "148c29b85992b8772eb7ddd518490110cacc", "main_account_iban": "DE17110101000000000042", "secondary_mappings": [ [] ], "updated_at": "2024-04-06T09:03:05.321+00:00" }

Responses

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

DISPUTE_CHANGEDWebhook

Request

The dispute internal state has been changed.

Bodyapplication/json
merchant_namestring

Name of the merchant where the original transaction was made.

Example: "112d31141ceb9e6f11demrc"
amountnumber

Disputed transaction amount.

Example: 800
created_atstring

UTC timestamp when the dispute was created.

Example: "2020-03-30T00:00:00Z"
original_transaction_datestring

UTC timestamp when the disputed transaction was made.

Example: "2020-02-30T00:00:00Z"
card_idstring

ID of the card, which was used in the transaction.

Example: "1fe8caa4bf1f49d87b2d63c14bb565f0mcrd"
person_idstring

ID of the person, who created the dispute.

Example: "0ba2211cab11af6094d60ead81f2bd9dcper"
external_refund_transaction_countnumber

Number of external refunds associated to this dispute.

Example: 0
external_refund_transaction_totalnumber

Amount of external refunds associated to this dispute.

Example: 0
statusstring(DisputeStatus)

Status of the dispute

Enum"NEW""ADDITIONAL_INFO_REQUIRED""DISPUTE_FILED""INITIATED""OPEN""INVESTIGATING""DONE_ACCEPTED_BY_SOLARIS""DONE_ACCEPTED_BY_SCHEME""DONE_REJECTED_BY_SOLARIS""DONE_REJECTED_BY_SCHEME"
Example: "INVESTIGATING"
application/json
{ "merchant_name": "112d31141ceb9e6f11demrc", "amount": 800, "created_at": "2020-03-30T00:00:00Z", "original_transaction_date": "2020-02-30T00:00:00Z", "card_id": "1fe8caa4bf1f49d87b2d63c14bb565f0mcrd", "person_id": "0ba2211cab11af6094d60ead81f2bd9dcper", "external_refund_transaction_count": 0, "external_refund_transaction_total": 0, "status": "INVESTIGATING" }

Responses

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