Skip to content
Download OpenAPI description
Languages
Servers
Mock Server

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

Operations
Webhooks

Request

A push provisioning token has been created or updated for a customer's card.

Bodyapplication/json
card_idstring

The ID of the card associated with the token.

Example: "8b48d56bdc1c091d9ab5547fe0e9511bmcrd"
token_reference_idstring

The unique reference ID of the token that was created.

Example: "DNITHE382228352676336613"
token_statusstring

The status of the token.

Enum"ACTIVE""DEACTIVATED""INACTIVE""SUSPENDED"
Example: "ACTIVE"
event_typestring

The event type of the token's lifecycle.

Enum"TOKEN_CREATED""TOKEN_STATUS_UPDATED""TOKEN_ACTIVATION_STIP"
Example: "TOKEN_CREATED"
message_reasonstring

Token's lifecycle event reason (from VISA's constantly changing message reason codes, e.g., TOKEN_CREATED).

Enum"CALL_CENTER_ACTIVATION""CARDHOLDER_STEPUP_RESULT""DEVICE_PROVISIONING_REPERSONALIZATION_RESULT""DEVICE_PROVISIONING_RESULT""LUK_REPLENISHMENT""MOBILE_BANK_APP_ACTIVATION""OTP_VERIFICATION_RESULT""TOKEN_CREATED""TOKEN_DEACTIVATED""TOKEN_DEVICE_BINDING_REMOVED"
Example: "TOKEN_CREATED"
client_wallet_account_idstring

Unique 24-byte identifier for each instance of a [Android user, Google account] pair. Google computes the ID as a keyed hash of the Android user ID and the Google account ID. The key to this hash lives on Google's servers; the wallet ID is created during user setup as an RPC.

Example: "Rwt3tJek_k1JxivcwbPHjKDk"
wallet_typestring

The type of the wallet.

Enum"APPLE""GOOGLE""SAMSUNG"
Example: "APPLE"
pan_reference_idstring

ID of the Primary Account Number (PAN) reference.

Example: "V-3019278454673935797827"
visa_pan_reference_idstringDeprecated

ID of the Primary Account Number (PAN) reference. Only appears in webhook notifications related to VISA cards. Deprecated in favor of pan_reference_id.

Example: "V-3019278454673935797827"
application/json
{ "card_id": "8b48d56bdc1c091d9ab5547fe0e9511bmcrd", "token_reference_id": "DNITHE382228352676336613", "token_status": "ACTIVE", "event_type": "TOKEN_CREATED", "message_reason": "TOKEN_CREATED", "client_wallet_account_id": "Rwt3tJek_k1JxivcwbPHjKDk", "wallet_type": "APPLE", "visa_pan_reference_id": "V-3019278454673935797827", "pan_reference_id": "V-3019278454673935797827" }

Responses

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

CASH_OPERATION_STATUS_CHANGEDWebhook

Request

A customer has paid out/paid in to a cash operation, or the cash operation has expired.

Bodyapplication/json
idstring

ID of the cash operation.

barcode_ean_13string

The EAN-13 barcode that your solution must generate so that the customer can present it at the merchant POS to complete the cash operation.

expires_atstring(date-time)

The date and time when the cash operation barcode expires.

statusstring

The current status of the cash operation.

Enum"PENDING""CREATED""PAID""EXPIRED""CANCELLED"
reference_idstring

End-to-end reference for the customer.

person_idstring

ID of the person who initiated the cash operation.

application/json
{ "id": "string", "barcode_ean_13": "string", "expires_at": "2019-08-24T14:15:22Z", "status": "PENDING", "reference_id": "string", "person_id": "string" }

Responses

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

CONSUMER_FRONTING_APPLICATIONWebhook

Request

The status of a consumer loan application has changed.

Bodyapplication/json
idstringrequired

The unique ID of the fronting loan, generated after a loan is created for the customer.

Example: "620b95f7987243d398c2621c889a2039cflo"
application_idstringrequired

The unique ID of a consumer fronting loan application.

Example: "504f3c3659e14079a6941fe5b7a75eaacfla"
agionumber(float)required

The credit commission amount.

Example: 0
durationintegerrequired

The number of months over which the loan will be repaid.

Example: 12
recipient_ibanstringrequired

The IBAN of the loan's recipient to which the loan will be paid out.

Example: "DE92370601930002130041"
recipient_namestringrequired

The name of the loan recipient.

Example: "Max Mustermann"
requested_interest_ratenumber(float)required

The interest rate to apply to the fronting loan.

Example: 0.04
amountobject(SolarisToolkit.Web.Money)required

The loan amount.

Example: {"value":1000,"unit":"cents","currency":"EUR"}
amount.​valueintegerrequired

The amount value

Example: 1000
amount.​currencystringrequired

The currency of the given value. Only EURO is currently supported.

Example: "EUR"
amount.​unitstringrequired

The unit of the given value.

Value"cents"
Example: "cents"
collateral_account_ibanstringrequired

Your Solaris prefund account from which the full loan amount (agio + net loan amount) must be transferred to Solaris' settlement account.

Example: "DE85110101014480677574"
collection_account_ibanstringrequired

Your account to which the agio is transferred.

Example: "DE87110101001000057123"
settlement_account_ibanstringrequired

The Solaris settlement account from which the loan amount is transferred to the customer's account.

Example: "DE07110101014503906016"
statusstringrequired

The status of the consumer fronting loan.

Enum"payout_issued""payout_pending"
Example: "payout_issued"
application/json
{ "agio": 0, "amount": { "value": 1000, "unit": "cents", "currency": "EUR" }, "application_id": "504f3c3659e14079a6941fe5b7a75eaacfla", "collateral_account_iban": "DE85110101014480677574", "collection_account_iban": "DE87110101001000057123", "duration": 12, "id": "620b95f7987243d398c2621c889a2039cflo", "recipient_iban": "DE92370601930002130041", "recipient_name": "Max Mustermann", "requested_interest_rate": 0.04, "settlement_account_iban": "DE07110101014503906016", "status": "payout_issued" }

Responses

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