Skip to content
Webhooks
/
/
RESERVATION_RESOLVED

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

RESERVATION_CREATEDWebhook

Request

A reservation was created on a customer's account. This webhook event is only for seizure-related reservations.

Bodyapplication/json
idstring

ID of the reservation that was created.

Example: "b814e2213c5c45149945ed53422db0c4cres"
amountobject

Amount of the reservation (in Euro cents).

reservation_typestring

The type of reservation.

Enum"CARD_AUTHORIZATION""CLEARING_TRANSACTION""INTRA_CUSTOMER_TRANSFER""SEIZURE""SEPA_CREDIT_BATCH""SEPA_CREDIT_TRANSFER""ProtectedAccountSeizure""SEPAInstantCreditTransfer"
Example: "SEIZURE"
referencestring

Reference number for the reservation.

Example: "1234567example"
statusstring

The current status of the reservation. Possible values are OPEN and RESOLVED.

Enum"OPEN""RESOLVED"
Example: "OPEN"
descriptionstring

Seizure-related reservation.

ibanstring

IBAN of the account on which the reservation was created.

Example: "DE87110101001000057123"
account_idstring

ID of the account on which the reservation was created.

Example: "adc123a45d6d7cf8fbfeed537ba919d5cacc"
created_atstring

UTC timestamp from when the reservation was created on the account.

Example: "2022-05-19T13:30:30Z"
resolved_atstring

UTC timestamp from when the reservation was resolved on the account.

meta_infoobject(Solaris-Resources-MetaInfo)

An object containing all meta information related to the reservation.

application/json
{
  "id": "b814e2213c5c45149945ed53422db0c4cres",
  "amount": {
    "value": 800,
    "unit": "cents",
    "currency": "EUR"
  },
  "reservation_type": "SEIZURE",
  "reference": "1234567example",
  "status": "OPEN",
  "description": "string",
  "iban": "DE87110101001000057123",
  "account_id": "adc123a45d6d7cf8fbfeed537ba919d5cacc",
  "created_at": "2022-05-19T13:30:30Z",
  "resolved_at": "string",
  "meta_info": {
    "cards": { … }
  }
}

Responses

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

RESERVATION_RESOLVEDWebhook

Request

A reservation on a customer's account was resolved. This webhook event is only for seizure-related reservations.

Bodyapplication/json
idstring

ID of the reservation that was resolved.

Example: "b814e2213c5c45149945ed53422db0c4cres"
amountobject

Amount of the reservation (in Euro cents).

reservation_typestring

The type of reservation.

Enum"CARD_AUTHORIZATION""CLEARING_TRANSACTION""INTRA_CUSTOMER_TRANSFER""SEIZURE""SEPA_CREDIT_BATCH""SEPA_CREDIT_TRANSFER""ProtectedAccountSeizure""SEPAInstantCreditTransfer"
Example: "SEIZURE"
referencestring

Reference number for the reservation.

Example: "1234567example"
statusstring

The current status of the reservation. Possible values are OPEN and RESOLVED.

Enum"OPEN""RESOLVED"
Example: "RESOLVED"
descriptionstring

Seizure-related reservation.

ibanstring

IBAN of the account on which the reservation was created.

Example: "DE87110101001000057123"
account_idstring

ID of the account on which the reservation was created.

Example: "adc123a45d6d7cf8fbfeed537ba919d5cacc"
created_atstring

UTC timestamp from when the reservation was created on the account.

Example: "2022-05-19T13:30:30Z"
resolved_atstring

UTC timestamp from when the reservation was resolved on the account.

Example: "2022-08-19T13:30:30Z"
meta_infoobject(Solaris-Resources-MetaInfo)

An object containing all meta information related to the reservation.

application/json
{
  "id": "b814e2213c5c45149945ed53422db0c4cres",
  "amount": {
    "value": 800,
    "unit": "cents",
    "currency": "EUR"
  },
  "reservation_type": "SEIZURE",
  "reference": "1234567example",
  "status": "RESOLVED",
  "description": "string",
  "iban": "DE87110101001000057123",
  "account_id": "adc123a45d6d7cf8fbfeed537ba919d5cacc",
  "created_at": "2022-05-19T13:30:30Z",
  "resolved_at": "2022-08-19T13:30:30Z",
  "meta_info": {
    "cards": { … }
  }
}

Responses

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

SCA_CHALLENGEWebhook

Request

A customer has made a purchase or performed a card servicing operation (e.g., adding a card to a Google or Apple Pay wallet) that requires authentication.

Bodyapplication/json
amountobject

The transaction's amount.

merchantobject

The merchant related to the transaction.

challenged_atstring(datetime)

UTC timestamp from when the authentication challenge was presented to the customer.

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

UTC timestamp from when the authentication challenge was expired.

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

The person ID of the customer who initiated the action requiring authentication.

Example: "682a85d7e490c1360f6c2be2f1addd57cper"
card_idstring

The ID of the card that was used for the 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"
challenge_idstring

ID of the SCA challenge. Use this parameter for declining the transaction.

Example: "8bc7c682cf2b47fbb0da40146h2gscachal"
channelstring

The channel that was used for the 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",
  "challenge_id": "8bc7c682cf2b47fbb0da40146h2gscachal",
  "channel": "browser"
}

Responses

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