Skip to content
Download OpenAPI description
Languages
Servers
Mock Server

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

Operations
Webhooks

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.

Request

To start receiving updates about application Decoupled Cards product.

Bodyapplication/json
idstring

ID of the SDD collection application.

Example: "dec2961f594045159195ca66e55fd6ea"
person_idstring

ID of the person who created the SDD collection application.

Example: "ec71f4b0456b424b97cc8be75b2c77d4"
credit_record_idstring

The credit_record_id of the SDD collection application.

Example: "84f468eacc7a4784ba0d4b0b577a9265"
sdd_collection_idstring

ID of the SDD collection.

Example: "c06fbfcc98b04376a9f220c4578932e4"
account_snapshot_idstring

ID of the relevant account snapshot record.

Example: "973a5f01ed7a416fadfed954c5bce782"
statusstring

The current status of the SDD collection application.

Example: "pending"
decisionstring

The decision taken on the SDD collection application.

Enum"OFFERED""REJECTED"
Example: "OFFERED"
rejection_reasonsArray of strings

An array of reasons why the SDD collection application was rejected.

Items Enum"not_preferred_alternate_offer""probability_of_default"
Example: ["probability_of_default"]
created_atstring(date-time)

UTC timestamp from when the application was created.

Example: "2021-10-20T14:45:54Z"
limitobject
application/json
{ "id": "dec2961f594045159195ca66e55fd6ea", "person_id": "ec71f4b0456b424b97cc8be75b2c77d4", "credit_record_id": "84f468eacc7a4784ba0d4b0b577a9265", "sdd_collection_id": "c06fbfcc98b04376a9f220c4578932e4", "account_snapshot_id": "973a5f01ed7a416fadfed954c5bce782", "status": "pending", "decision": "OFFERED", "rejection_reasons": [ "probability_of_default" ], "created_at": "2021-10-20T14:45:54Z", "limit": { "value": 10000, "unit": "cents", "currency": "EUR" } }

Responses

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

SEPA_CREDIT_TRANSACTION_DECLINEDWebhook

Request

A SEPA Credit Transfer conducted by one of your customers was declined. The transaction may have initially been accepted, but then something changed (e.g., a block was placed on the account, the balance proved to be insufficient) and the transaction was declined instead of executed.

Bodyapplication/json
idstring

Unique ID of the transaction.

Example: "45bd0881-a79a-4054-9286-f11060d5511f"
statusstring

Status of the transaction.

Example: "declined"
referencestring

Optional unique reference. Used as an idempotency key.

Example: "8880a72c-2675-482d-8d88-70a02c608592"
amountobject

The amount of the transaction.

descriptionstring

Additional description about the transaction. Please note the SEPA character restrictions.

recipient_ibanstring

The recipient's IBAN.

Example: "DE87110101001000057123"
recipient_namestring

The recipient's name. Please note the SEPA character restrictions.

Example: "Max Mustermann"
recipient_bicstring

The recipient's BIC.

Example: "SOBKDEB2XXX"
end_to_end_idstring

SEPA identifier provided by the transaction initiator, which will be routed throughout the whole payment process. Please note the SEPA character restrictions.

Example: "END2ENDREJ"
schedule_idstring

Unique ID of the schedule transfer.

Example: "f874b3102718a4d757a6b6e4d599607csctr"
batch_idstring

Unique ID of the batch.

Example: "d6c778822b2d7bd3b778935bcfd0d1d3csc"
created_atstring(date-time)

UTC timestamp from when the transaction was created.

Example: "2021-01-01T20:37:50Z"
rejection_reasonstring

Reason why the transaction failed.

application/json
{ "id": "45bd0881-a79a-4054-9286-f11060d5511f", "status": "declined", "reference": "8880a72c-2675-482d-8d88-70a02c608592", "amount": { "value": 1000, "unit": "cents", "currency": "EUR" }, "description": "string", "recipient_iban": "DE87110101001000057123", "recipient_name": "Max Mustermann", "recipient_bic": "SOBKDEB2XXX", "end_to_end_id": "END2ENDREJ", "schedule_id": "f874b3102718a4d757a6b6e4d599607csctr", "batch_id": "d6c778822b2d7bd3b778935bcfd0d1d3csc", "created_at": "2021-01-01T20:37:50Z", "rejection_reason": "string" }

Responses

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