Download OpenAPI specification:Download
Creates a card in the name of the person specified in the request URL and attaches it to the given account.
Please note the following:
line_1
is not automatically generated. You must enter a value as close to the cardholder's actual name as possible.line_1
and line_2
may not exceed 21 characters./
between the cardholder's first and last name(s). Example: ADAM AARON/SCHMIDT
line_1
and line_2
: ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 -/.
Please convert accented characters to their non-accented equivalents (e.g., converting Ö
to OE
, É
to E
).WITHSTATICTOKEN
within the line_1
property. See the request example on the right for information on how to use it.GET Retrieve latest public key method
and make it available to the customer's device.RSA-OAEP-256
.A256CBC-HS512
.kid
property from the encryption key JWK.encrypted_pin
parameter.kid
property from GET /v1/cards/pin_keys/latest
is the kid
in the request.Successful creation
Validation error.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "line_1": "MICHAEL WITHSTATICTOKEN/MUSTERMANN",
- "line_2": "TEST COMPANY GMBH",
- "type": "MASTERCARD_BUSINESS_DEBIT",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "reference": "61a50bf05278217a57e5ad15ed259e44",
- "shipping_priority": "0",
- "encrypted_pin": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2Q0JDLUhTNTEyIiwia2lkIjoiN2FkOTFjYWQtODU0NC00ZmQyLWJlNDgtNDcyOTU3MGEzOTRhIn0.bDPrZvlJ9slqZ9WDy_PDCZrKCvFyLanAeDItyDFdaiRvQbsTdoDE5Y-etWN--y25HkMKzpbC0CIJHdN7kLa225Ax2O6SPaxDkGGNSQPKzkxXmimpv9zaRYNCVQ67KdVTK6WOVLjOVRBKZDba9zvzfKvXlBYqj51WyQR_yvxrXTPftX3IQkDo8RjdaB6tr9HugdimbqOiMgiNSOHAn0G-Zi6tkwL0TLlA5_8xzUec40vaBvEoTBc_OZjZy7s7ebKzS8Hhg6NF9CemeMIEwes8ZzO1s1385PCxLhce0KEekVUoCjrLP9QhoYSjQUTUNrxkn4h0ZnicF5ycbW36Ivt8mQ.sAtSq_rfcxxlQiQc2qZ0Kg.bW53DScq6C8vnqD620Lnuw.MYGA-87sfGrFupu2FqC3Ick_EvwCA5vO2tPktS1yJPg",
- "key_id": "7ad91cad-8544-4fd2-be48-4729570a394a"
}
{- "id": "8febdba4912a747808ccc6f95f82bbb4mcrd",
- "status": "PROCESSING"
}
Returns all cards associated with the person provided in the request URL
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/persons/{person_id}/cards?filter%5Bstatus%5D=string&page%5Bnumber%5D=1&page%5Bsize%5D=10'
[- {
- "id": "8febdba4912a747808ccc6f95f82bbb4",
- "status": "ACTIVE",
- "reference": "87285d83-ab15-4906-af87-5763801d9e43",
- "type": "MASTERCARD_DEBIT",
- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "5af2ea4271038d5c53e68ccbf4fe43b3cper",
- "account_id": "a5844f601567db9b59b3531245a58e96cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "BUSINESS NAME",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}, - "partner_id": "a0461d31b910023de5647306e1e9a62bcpar",
- "owner_1_id": "00059",
- "card_account_status": "active",
- "sia_related_account_id": "55874C893FE53ADFE44F01",
- "created_at": "2019-11-13T15:19:21.000Z",
- "iban": "DE00116474734556211581",
- "emoney_visa_settlement_iban": "string",
- "sia_account_number": "500000001103",
- "visa_profile_id": "string"
}
]
Returns all cards associated with the business specified in the request URL.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/businesses/{business_id}/cards?page%5Bnumber%5D=1&page%5Bsize%5D=10'
[- {
- "id": "8febdba4912a747808ccc6f95f82bbb4",
- "status": "ACTIVE",
- "reference": "87285d83-ab15-4906-af87-5763801d9e43",
- "type": "MASTERCARD_DEBIT",
- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "5af2ea4271038d5c53e68ccbf4fe43b3cper",
- "account_id": "a5844f601567db9b59b3531245a58e96cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "BUSINESS NAME",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}, - "creation_date": "2022-05-01",
- "sia_account_number": "500001650679"
}
]
Returns all cards associated with the cardAccount specified in the request URL.
Successful result of the operation
Validation error.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/accounts/{account_id}/cards?page%5Bnumber%5D=1&page%5Bsize%5D=10'
[- {
- "id": "8febdba4912a747808ccc6f95f82bbb4",
- "status": "ACTIVE",
- "reference": "87285d83-ab15-4906-af87-5763801d9e43",
- "type": "MASTERCARD_DEBIT",
- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "5af2ea4271038d5c53e68ccbf4fe43b3cper",
- "account_id": "a5844f601567db9b59b3531245a58e96cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "BUSINESS NAME",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}, - "creation_date": "2022-05-01",
- "sia_account_number": "500001650679"
}
]
Returns information about the card specified in the request URL.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/cards/{id}'
{- "id": "8febdba4912a747808ccc6f95f82bbb4",
- "status": "ACTIVE",
- "reference": "87285d83-ab15-4906-af87-5763801d9e43",
- "type": "MASTERCARD_DEBIT",
- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "5af2ea4271038d5c53e68ccbf4fe43b3cper",
- "account_id": "a5844f601567db9b59b3531245a58e96cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "BUSINESS NAME",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}, - "creation_date": "2022-05-01",
- "sia_account_number": "500001650679"
}
Returns all cards associated with partner.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
Internal server error.
Unexpected error
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/cards?filter%5Bbusiness_id%5D=string&filter%5Bperson_id%5D=string&filter%5Bperson_uid%5D=string&filter%5Baccount_id%5D=string&filter%5Baccount_uid%5D=string&filter%5Bstatus%5D=string&filter%5Btype%5D=string&filter%5Bmasked_pan%5D=string&filter%5Bline_1%5D=string&filter%5Bsia_account_number%5D=string&page%5Bnumber%5D=1&page%5Bsize%5D=10'
[- {
- "id": "8febdba4912a747808ccc6f95f82bbb4",
- "status": "ACTIVE",
- "reference": "87285d83-ab15-4906-af87-5763801d9e43",
- "type": "MASTERCARD_DEBIT",
- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "5af2ea4271038d5c53e68ccbf4fe43b3cper",
- "account_id": "a5844f601567db9b59b3531245a58e96cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "BUSINESS NAME",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}, - "creation_date": "2022-05-01",
- "sia_account_number": "500001650679"
}
]
Activates the card with the ID specified in the request URL. Please note the following preconditions:
ACTIVE
or INACTIVE
(if activating a replacement card).NO_BLOCK
.pan_last_4_digit
and expiry_date
. These are optional parameters you can collect from the cardholder upon receipt of their card in the mail, to ensure they are activating the right card. line_1
property when creating a card.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "pan_last_4_digit": "2314",
- "expiry_date": "01/23"
}
[- {
- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "6dceb838ea04090aaa4277c7ea8a1c78cper",
- "account_id": "6cbac416a5d91aaf5e6bc9ee15d58799cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "sia_account_number": "500000001103",
- "creation_date": "2022-05-01",
- "id": "2b890724292e287935420a2ca13ae7f9mcrd",
- "status": "ACTIVE",
- "reference": "b92b6840d6345b11f29b598c10bae770",
- "type": "MASTERCARD_DEBIT",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "TEST COMPANY GMBH",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}
}
]
Blocks the card with the ID specified in the request URL. Note that the card must have a status value of ACTIVE
in order to be blocked.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/cards/{card_account_id}/block'
{- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "6dceb838ea04090aaa4277c7ea8a1c78cper",
- "account_id": "6cbac416a5d91aaf5e6bc9ee15d58799cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "sia_account_number": "500000001103",
- "creation_date": "2022-05-01",
- "id": "2b890724292e287935420a2ca13ae7f9mcrd",
- "status": "ACTIVE",
- "reference": "b92b6840d6345b11f29b598c10bae770",
- "type": "MASTERCARD_DEBIT",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "TEST COMPANY GMBH",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}
}
Unblocks the card specified in the request URL. Please note that the card must have the status of BLOCKED
in order for you to unblock it with this method. If the card has the status BLOCKED_BY_SOLARIS
, then you cannot unblock it with this method.
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/cards/{card_account_id}/unblock'
{- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "6dceb838ea04090aaa4277c7ea8a1c78cper",
- "account_id": "6cbac416a5d91aaf5e6bc9ee15d58799cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "sia_account_number": "500000001103",
- "creation_date": "2022-05-01",
- "id": "2b890724292e287935420a2ca13ae7f9mcrd",
- "status": "ACTIVE",
- "reference": "b92b6840d6345b11f29b598c10bae770",
- "type": "MASTERCARD_DEBIT",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "TEST COMPANY GMBH",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}
}
Issues a replacement for the card specified in the request URL. Specify the appropriate reason
in your request to trigger the right replacement process:
EXPIRES_SOON
DEFECTIVE_CARD
, CARDHOLDER_REQUEST
(Deprecated) LOST
, STOLEN
, COUNTERFEIT_PLASTIC
, PREVENTIVE_BLOCK
, ONLINE_TRANSACTION_FRAUD
PROCESSING
, then ACTIVE
or BLOCKED
depending on the card's status prior to ordering. The value of the new_card_ordered
property on the card resource will change to true
.new_card_ordered
will change to false
.ACTIVE
, INACTIVE
ACTIVE
, INACTIVE
, BLOCKED
, BLOCKED_BY_SOLARIS
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "line_1": "JOHN/DOE",
- "line_2": "TEST GMBH",
- "reason": "DEFECTIVE_CARD",
- "reference": "7dc5377e-b90b-3401-b9a5-5dd094893e28",
- "retain_pin": true,
- "reported_at": "2020-01-13T09:56:24.000Z"
}
{- "id": "2b890724292e287935420a2ca13ae7f9mcrd",
- "status": "PROCESSING"
}
Note: This endpoint is deprecated. Please use the POST Replace a card endpoint instead. Read the endpoint summary to learn how to use the endpoint for the lost/stolen use case.
Reports the card specified in the request URL as lost or stolen. The card will be immediately blacklisted. Please note the following:
status
of the card must only be one of the following values: ACTIVE
, INACTIVE
, BLOCKED
, or BLOCKED_BY_SOLARIS
.POST Replace a card
endpoint.order_replacement
to true
.POST Create a card
endpoint to order them a new one.lost_at
to 2021-06-03T18:31:09+00:00
.Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "loss_reason": "HOME_INVASION",
- "lost_at": "2020-01-13T09:56:24.000Z",
- "order_replacement": false,
- "retain_pin": false
}
[- {
- "id": "a2f0129cb1194a688dace3b678a85268",
- "card_id": "8febdba4912a747808ccc6f95f82aaa4",
- "loss_reason": "MAILBOX_THEFT",
- "lost_at": "2023-05-23T12:56:45+00:00",
- "card_status": "STOLEN"
}
]
Closes the card with the ID specified in the request URL.
Note: this action cannot be undone.
In order to be closed, the card must have one of the following statuses:
ACTIVE
BLOCKED
COUNTERFEIT_CARD
FRAUD
INACTIVE
LOST
NEVER_RECEIVED
STOLEN
Successful result of the operation
Invalid request.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/cards/{card_account_id}/close'
[- {
- "expiration_date": "2020-12-30",
- "new_card_ordered": false,
- "person_id": "6dceb838ea04090aaa4277c7ea8a1c78cper",
- "account_id": "6cbac416a5d91aaf5e6bc9ee15d58799cacc",
- "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
- "sia_account_number": "500000001103",
- "creation_date": "2022-05-01",
- "id": "2b890724292e287935420a2ca13ae7f9mcrd",
- "status": "ACTIVE",
- "reference": "b92b6840d6345b11f29b598c10bae770",
- "type": "MASTERCARD_DEBIT",
- "representation": {
- "line_1": "SLY STALLONE",
- "line_2": "TEST COMPANY GMBH",
- "masked_pan": "537458******4567",
- "formatted_expiration_date": "09/22"
}
}
]
Retrieves the card number, expiry date, and CVV for the card specified in the request URL. The response is encrypted; your customer must decrypt it using a bound device.
Please note the following prerequisites:
device_id
in this request.The content of the request
device_id required | string ID of the customer's bound device. |
device_data | string Encoded device fingerprint generated using the Seon SDK. See the device monitoring guide for more information about generating this value. |
signature required | string The device signature obtained during the device binding process. The signature must be generated using the device's unrestricted key.
|
required | object JSON Web Key (JWK) data that will be used to encrypt the card details. Click here to learn more about this algorithm. |
required | object JSON Web Encryption attributes. |
Successful result of the operation
Validation error.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
{- "device_id": "ZtzhX7M96stcA2LzDpX1Lg8dev",
- "device_data": "Web;179ac83968ab42f79e960c1753a4078fdcon;jVl14emA+OcyALb9F+CMFg==;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",
- "signature": "556F4558783743346570744B674D3838454E3444334F627141394E696735726B3946593739356B413353337359767A34756F387977754D2F4658536134327A41394454716D3337616570764335346A477276744579376246514B546C79465A6A7A532F577545722B4946644A4A2F674953784E7A715451765A3077432B39486E6F4B7A36447050725537695657476A626B3057366549746363312F577654742F39594D4B726B7541506E49426B4A74426B737254687867562B3169636155582B432B426F41696A64544A314D773774624F70556F4C686257392F496936773235744472494E33564A6166446E6F634E523438335469595568382B70343946703473395971434872503270395959616B513155795673444635504B45596B75784A2F7A797933334779686732744D5473435238476B7959657648372F31733532472B6C73573048754F597A4C364E324954426B6C666D413D3D0D0A",
- "jwk": {
- "kty": "RSA",
- "use": "enc",
- "alg": "RS256",
- "kid": "cf8e03cd-0292-47e2-8e26-c167293b9187",
- "n": "ZtzhX7M96stcA2LzDpX1Lmr0Y7tH1JnHvK5BmRQsy5hm1vAneRgictJB7yfW9JcZSpHeDspVkXVXuL3ddO1tVWOs4pln65Iklz5EtYKgoKaVBkUFNP1wDgEDTPhX6dS46/Ua1Z39RPAl21s2gQkzAL8UjC67kwH+FJnzLqBEE57L0eJNOU2VnBVwVob8GM8B6/KTblhr5wUw/o1K2qFXhjpkopz+SV1mqd61I/9H8gvb/clKuwpI+c/jyV0O55Y7vQDBdL37MReuSgHJvYtOnjLSHTNrB+lhNt6kg/MEtfs/e6iX+MV9d4Is5AvkDSXcMg+Im4aiKK4UeKcrSOtTcw==",
- "e": "AQAB"
}, - "jwe": {
- "alg": "RSA1_5",
- "enc": "A256GCM"
}
}
{- "data": "W2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awaW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awaW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awaW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awaW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awaW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awa"
}
Returns the latest Solaris public RSA key in JWK format. Call this method every time before you call the POST Change card PIN
method to ensure you have the latest key. See RFC7517 for more information on JWKs.
The public key was fetched successfully.
Invalid/missing OAuth token.
Unauthorized action.
The card could not be found.
Internal server error.
curl -i -X GET \ https://api.solaris-sandbox.de/v1/cards/pin_keys/latest
{- "kid": "0dce6f4d-b5d0-4c7b-a7d8-cfe231a1f385",
- "kty": "RSA",
- "use": "enc",
- "alg": "RS256",
- "n": "ielfymjYSKEeeai7pFBhJrr0aR-B5_T0snVgQSm8K-SsFv3MFofkeWxWT3PCBId8kovdI-gfKabCyhuQDaYbXP1opyEkB9-gyG4zqmWoW9ddmWo-wxaW08KiruNl09IjWJR0w93tM0i8Pn2qpCSM3h0CdgfO9-VjLn1BpYFKjuJ1apZQ3TG1YYIfGSymghUl0JWLu0s5J2BrvEz91E0K4aF-VY4oSnlrTilq3FrCOgF8IopUvqJWIsz-hKagNAP1K4AXoSVX7Kc4MxUcZEIlkeMKj05YF3zoFhOzfQCa5kcYdPFNlEOpuZwuMidYw8LNBFdvV4VeKYUXZrvaW-SKUQ",
- "e": "AQAB"
}
Deprecated endpoint. Returns the latest Solaris public RSA key in JWK format. Call this method every time before you call the POST Change card PIN
method to ensure you have the latest key. See RFC7517 for more information on JWKs.
The public key was fetched successfully.
Invalid/missing OAuth token.
Unauthorized action.
The card could not be found.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/cards/{card_account_id}/pin_keys/latest'
{- "kid": "0dce6f4d-b5d0-4c7b-a7d8-cfe231a1f385",
- "kty": "RSA",
- "use": "enc",
- "alg": "RS256",
- "n": "ielfymjYSKEeeai7pFBhJrr0aR-B5_T0snVgQSm8K-SsFv3MFofkeWxWT3PCBId8kovdI-gfKabCyhuQDaYbXP1opyEkB9-gyG4zqmWoW9ddmWo-wxaW08KiruNl09IjWJR0w93tM0i8Pn2qpCSM3h0CdgfO9-VjLn1BpYFKjuJ1apZQ3TG1YYIfGSymghUl0JWLu0s5J2BrvEz91E0K4aF-VY4oSnlrTilq3FrCOgF8IopUvqJWIsz-hKagNAP1K4AXoSVX7Kc4MxUcZEIlkeMKj05YF3zoFhOzfQCa5kcYdPFNlEOpuZwuMidYw8LNBFdvV4VeKYUXZrvaW-SKUQ",
- "e": "AQAB"
}
Changes the PIN of the card specified in the request URL. Follow these instructions to use this endpoint:
GET Retrieve latest public key
method and make it available to the customer's device.{"pin": "<NEW_PIN>"}
.RSA-OAEP-256
A256CBC-HS512
kid
property from the encryption key JWKencrypted_pin
parameter.signature
parameter. Note that you must use the restricted key.device_id required | string ID of the customer's previously bound device. |
device_data | string Encoded device fingerprint generated using the Seon SDK. See the device monitoring guide for more information about generating this value. |
encrypted_pin required | string The encrypted PIN value (JWE in compact serialization). See the description of this method for instructions on how to produce this value. |
key_id required | string Solaris' public RSA key ID. Returned as the |
signature required | string The signature of the |
The card's PIN was successfully changed.
Validation error.
Unauthorized action.
The card could not be found.
Internal server error.
{- "encrypted_pin": "Web;179ac83968ab42f79e960c1753a4078fdcon;jVl14emA+OcyALb9F+CMFg==;NU7aFh0jdzM15wj8hQtqbA5LbzEFWDI1bUwZf/zbau0P2MIEUE+LsifBKvxjCYNUyz647bpSjnQ6Tu8IK22sxFlTGEFaHKBigzmP8Nc8FvVSWKzslmSWTFJM5AYc+EGTZLprlcdrLldsZLS5PpHfPMmvtqCXVTnGhYV7GvutI1w5/67yK7pCQDxDicKjqlMg1naMiwCuqP1U1lUtf+lTdmJ1T1lXMPARffTn4XAr66vUxN++sy7qytkdcOeCsaxZnLspUEvqu+2ILHF8pOJFG7gYC11rqWOyHG3Ns1E1dZ57ybrgGTKfctFOdx2IMXnz1/i/pDC5QokRr2BTIZZ/9Tj+xXzWpzNwHtRWWK5VEufyVRPyMXQdmry7UYKrouAzlLCYSMv7GcPwOZz+gDjCkrNia7/DGBBFLOvtlufDztPpvkH2jmN32/oJHl1Qu6zpxG3Lyl8RNdyukuNYfiPw0ECoXsXObwQc7Ja8R+V5S7QZeV1VV9aavlH1+Xl9v0OlOJ1XujO7izWESMIfzAuaL6ACYhdkmkC3kicjOWUjaY3OJYrrXxQ+MScnJOQ9neMRWij7YqNxP8F259zVjqqyaL6hN8EZU/pi+cZUVkfFvMYT5ugE9JXjkFfyy4UQeSmNRjDXRzu40LyweqUns8u3GOIFzfZ9eVOv+q7OV+RpVLOJLz1Za8RPIh3UKltCzOTmO8OpDz2aGoqNdL4zAaLl4EKRoarEiSG9K2/GoyHchi6xdHYA6DqQg5xQM4s50RUySGwWLxBB3ZlMpZpdZAVBrLSyl1SWqYTosdyURtiiX0So+kdik5XJ5Vsh0v75rNP5Yrv3t5/u94wx51zKlpDH8Uiap7kP0eibRmmN196kxMcOf8Q50JM1Yt8cJiawTWdGHzGRcNtEkpon5VLp/kwDU+4IPwlW976hKsom0PTB/EVxo5CWuL6kPiaEWUrWOL7BZ2jkuebHT2jBAJuFBaeac7IYnrAMoLgfY33Vs3EtVk8H12iDX3O9JmGsDGXP0/vBx0uFEgrTt6HjwabWGRHpPPPCorSrjfuySwKlnZtp1KkeNrOso8K8DBW6e+6j1YYaxTjBUZSLl1qgzd1dpz85vB/trWdyS3i+APHw/AsP/Y4cmu/CFZqpe1Sgye1+YNP3Hs3LpxJKM3prnAoaCmrHp5aUKo5KdicAnilBTzBAV2zGBWHrBwWLWHl+RDQpncyWD2/ZCswxtXbQAhlmVD7FvBXnT0Yyg5gaFo5GVBcURzBYtwbdl3+6sqKtR3XC22GBw0OOqZ9/QvMHmCO/K89rEjfLEaVX4eKhrdzjxOwOxmE5lXrLqfscV90Yo9Uj1awvpF5TL5vW85asT2iVHYjZ1JsQ5oLp3VUfIAqTNmpcjRk763hMsTUIrn3VfpLkGajZbtxD2FuNNMoRZQBfiOAxPUDFmspxWagNSbmUZ8FqPX/6asQIJIyvAk4cvzgV9OjzdkoEcFP2OGjFnddZtLmBh9BZDWtS3VOL98lp+cH/JAn8pDab2l6zIwHRccePbuBcGZZgU39FOVpI+sbHZJ6QEhiUA8SdT7SLcTf4P1tBbdN5+dpjaWfTph1cgZyW8EsAIFc81vR6tBqSSpxmS164ADWZW+PYz4b4SRVklT3Cs2tJ/TTMM240pnkNJUd3G/0PbBGVPea5+XUs1bF5cT0fiHWA032Dm87biMEU89fdPkvnSlIsN/MbLT2kj2tPZqhOrqTxCg26jimd+2kNdZ2fwvT8JQfO0hVidnPDPLXH5aA6T6+bKqfpvJE6USAif8fPQ0rW4+315LKH5wG8Qj0omO2Ynii0IE6cR0lAGrtoLsXMf3kDqFms+Z2h79pYQrnhUSntZ3tjt3pwgejJ8ZKXdN7kYWT8UiQnLnkfLJnh1e8a4UURe7GU9UwnqqFXeHrstb8XXxiIX7syFG5iLdN9IExi5BefYnAikCTU+ssMWnnhppX6jFV43u+KEaa1/7AqibMc3Kt+kUxHlQsAo2TCg+u/39rsgNs5eWym7YptvBCN6L4Q4QRoKNFo8CJerS4dTxksD2zeGL4BLIsvMbcm6rlHrKCR5PeWRiFpK8QwwaOyiTGL5NN2Xl6F0M4vf5gnWikZTrppv7bLUYZhrU1uGiv968ZGEq+A7w2oLvbZS7l+DZuN4rPF5SzPWq94jC1NiYjaPrGyTQIISRiBLXil5puqCobYHAIeVQzHBgki3/N+Pwk4iCrxf3pqnUSNmtrmvphmo9Vp3xAaPSFsUYfIyOPiO5gcNUoGQ1kHZ3Yoksqh6U1hRCzlkMSbX6kzDYUNEgc47t2AKxLM5IpYCWAv+uefNAAb/4+f7Qh4sMqtXHc5lGK3GN8ABTIVeFphtJg36Y6xg8OTrBR5ItS/tdy6zyfTLfZFocRbfjsLfoiCeHJO0sEZIWgHsu80FVZmo4G84N6zNZkdjnFDZkgRYP9OSqMbPCXyb5Xj1H6g67rNjtY67B3613uGJ0pHCQpl0Lmz2apUMq9EVRz5tZT+RA8sCRcK4mkBEWzdC7ngI5+dfX2dEqu157rsc0yU4OWNElLWC3F1TXOsB2/n1+LBHpjKLIMok2afui1H9+eof1zLAba4hrnYEFI4WjvEAvcsyPI/eONNdxk7liVNNaD7j6vvwYKOxTZoriKwvGxeNApC+Z8xQ8HpnEaRIUqb2Eh1SfpyDta8J1dXnRF1HTq2pOvfitomb701g0diB7+StEpCxiRLCx3TEJcroqBiCE3szXdc9VSVyfklkHmbJE33CY8tGm1YEvaXAY7a5yWLHWHzqQvNuZkQ1DNbJAkP9dt1t8Fv3njG2lXFmAOJkZwpvm9qEHZTmuUmflIMhu9nMsgZd5VMjalTmHqZdy7zmnAz8LhYiUDMbPDNOd4UTehvTanDEBBYTJB6CYv6QnBYwuAPsZwRnZdHbpl6lIXStmgsxV3DLtKAUy8eoqCdDOMyep9L4ArSWEJstEBNkZ5zgk7bOspvF1V8HrhFzJCiwR7WC+GHJTHLH1S8FfmHFTXJHecvq6tpMncaJFbo4jSfm9ozBAVAAN2mCn/yBbmX9tPmXdGEsTSpdp6vVWKEdHZ1rjCqmgDENxh75H5uT9DeZ0mAKwkP5Ai+bN3hT0y1XGE44b/aJ7PEObogYAioej/Z690zKx+fHxP50juTgt+UIQ+l/mpcYnbcYe4lkXrqGpwxFU8OrRzzfJX/s90VVlzrQVAPNW/mvYkt+MqSVwI1EP62faXlXnDqbmVFUmMGeoquP58cwqSBaNL/oi2Rg7GVvdvus+i2Qpm1SHtnPVUhTwWFigiWw/T2ZZeUs4nk+Q/xOFa/",
- "key_id": "0dce6f4d-b5d0-4c7b-a7d8-cfe231a1f385",
- "device_id": "d3768ef3-b26b-4746-9ee0-94f527184830",
- "device_data": "Web;179ac83968ab42f79e960c1753a4078fdcon;jVl14emA+OcyALb9F+CMFg==;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",
- "signature": "3045022100ef4f8ede9999e1338a2af0ecd5c183c306fc1d134302895aa813bd0434b0a5d90220567e1c5d16d6be0f3a8553fcfdd765e8fefb169532fbf6932d96075358b46328"
}
{- "errors": [
- {
- "id": "c3a1ff40c31e428d8deaf77c71fe606eex",
- "status": 400,
- "code": "type_error",
- "title": "Request parameter error",
- "detail": "Incorrect request parameter was provided",
- "source": {
- "field": "card_account_id",
- "message": "Format is incorrect"
}
}
]
}
Changes the PIN of the card specified in the request URL using the Change Request process. Follow these instructions to use this endpoint:
GET Retrieve latest public key
method and make it available.{"pin": "<NEW_PIN>"}
.RSA-OAEP-256
A256CBC-HS512
kid
property from the encryption key JWKencrypted_pin
parameter.The request was accepted, and now the customer must confirm the change request.
Validation error.
Unauthorized action.
The card could not be found.
Internal server error.
{- "encrypted_pin": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2Q0JDLUhTNTEyIiwia2lkIjoiN2FkOTFjYWQtODU0NC00ZmQyLWJlNDgtNDcyOTU3MGEzOTRhIn0.bDPrZvlJ9slqZ9WDy_PDCZrKCvFyLanAeDItyDFdaiRvQbsTdoDE5Y-etWN--y25HkMKzpbC0CIJHdN7kLa225Ax2O6SPaxDkGGNSQPKzkxXmimpv9zaRYNCVQ67KdVTK6WOVLjOVRBKZDba9zvzfKvXlBYqj51WyQR_yvxrXTPftX3IQkDo8RjdaB6tr9HugdimbqOiMgiNSOHAn0G-Zi6tkwL0TLlA5_8xzUec40vaBvEoTBc_OZjZy7s7ebKzS8Hhg6NF9CemeMIEwes8ZzO1s1385PCxLhce0KEekVUoCjrLP9QhoYSjQUTUNrxkn4h0ZnicF5ycbW36Ivt8mQ.sAtSq_rfcxxlQiQc2qZ0Kg.bW53DScq6C8vnqD620Lnuw.MYGA-87sfGrFupu2FqC3Ick_EvwCA5vO2tPktS1yJPg",
- "key_id": "7ad91cad-8544-4fd2-be48-4729570a394a"
}
{- "id": "d6c778822b2d7bd3b778935bcfd0d1d3csc",
- "status": "CONFIRMATION_REQUIRED",
- "updated_at": "2022-04-21T13:59:52+00:00",
}
Creates a card controls list and applies it to all cards defined in the scope
and scope_id
of the request.
The card controls list was successfully created.
The card controls list has already been created.
Validation failed for the card controls list, or the provided partner identifier is invalid.
You are not authorized to perform this action.
The card controls list could not be found.
Internal server error.
{- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "inclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}, - "exclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}
}
{- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "inclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}, - "exclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}
}
Returns an array containing all active card controls lists in place for your customers.
Successful result of the operation
Request validation failed.
You are not authorized to perform this action.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/card_controls/lists?filter%5Bscope%5D=CARD&filter%5Bscope_id%5D=string&include_related=true'
[- {
- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "inclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}, - "exclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}
}
]
Returns the card controls list with the ID specified in the request URL.
The operation was successful.
Partner identifier is invalid
You are not authorized to perform this action.
The card controls list could not be found.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/card_controls/lists/{id}'
{- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "inclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}, - "exclusion": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
]
}
}
Deletes the card controls list specified in the request URL.
No Content
Partner identifier is invalid
You are not authorized to perform this action.
Card controls list not found
Internal server error.
curl -i -X DELETE \ 'https://api.solaris-sandbox.de/v1/card_controls/lists/{id}'
[- {
- "errors": [
- {
- "id": "a1aeac6a-00ff-11ec-9a03-0242ac130003",
- "status": 404,
- "code": "not_found_card_control",
- "title": "Not found card control",
- "detail": "Not found card control <b764d818-de07-4e0a-975f-91f13a51e121>"
}
]
}
]
Creates a card spending limit control and applies it to all cards defined in the scope
and scope_id
of the request.
The card spending limit control was successfully created.
The card spending limit control has already been created.
The request validation failed.
You are not authorized to perform this action.
Internal server error.
{- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "period": "HOURLY",
- "amount": 10000,
- "count": 0
}
}
{- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "period": "HOURLY",
- "amount": 10000,
- "count": 0
}
}
Returns all active card spending limit controls.
Successful result of the operation
The request validation failed.
You are not authorized to perform this action.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/card_controls/spending_limits?filter%5Bscope%5D=CARD&filter%5Bscope_id%5D=string&include_related=true'
[- {
- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "period": "HOURLY",
- "amount": 10000,
- "count": 0
}
}
]
Returns information about the card spending limit control specified in the request URL.
Successful result of the operation
The supplied partner identifier is invalid.
You are not authorized to perform this action.
The card spending limit control could not be found.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/card_controls/spending_limits/{id}'
{- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "period": "HOURLY",
- "amount": 10000,
- "count": 0
}, - "utilized_limit": {
- "amount": 10000,
- "count": 5
}
}
Deletes the card spending limit control specified in the request URL.
No Content
The supplied partner identifier is invalid.
You are not authorized to perform this action.
Card controls spending limit not found
Internal server error.
curl -i -X DELETE \ 'https://api.solaris-sandbox.de/v1/card_controls/spending_limits/{id}'
[- {
- "id": "a95f2aaf-4e0c-4d49-8021-8a16a884ed86",
- "status": "400",
- "code": "build_pagination_headers_failure",
- "title": "Failed to build pagination headers.",
- "detail": "Cannot connect to database."
}
]
Creates a card spending limit control and applies it to all cards defined in the scope
and scope_id
of the request.
Important This endpoint replaces the old version. However, please note that you have to set the api-version
header to the version you want (e.g., 2024-01-01
). If you do not specify a version, then the API will return the older version of the response.
The card spending limit control was successfully created.
The card spending limit control has already been created.
The request validation failed.
You are not authorized to perform this action.
Internal server error.
{- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "period": "HOURLY",
- "amount": 10000,
- "count": 0,
- "conditions": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "excluded_dimension": [
- "5411"
]
}
}
}
{- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "period": "HOURLY",
- "amount": 10000,
- "count": 0,
- "conditions": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "excluded_dimension": [
- "5411"
]
}
}
}
Returns all active card spending limit controls.
Important This endpoint replaces the old version. However, please note that you have to set the api-version
header to the version you want (e.g., 2024-01-01
). If you do not specify an api-version
, then the API will return the older version of the response.
Successful result of the operation
The request validation failed.
You are not authorized to perform this action.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/card_controls/spending_limits(use%20api-version-header%20to%20consume%20this%20endpoint)?filter%5Bscope%5D=CARD&filter%5Bscope_id%5D=string&include_related=true'
[- {
- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "period": "HOURLY",
- "amount": 10000,
- "count": 0,
- "conditions": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "excluded_dimension": [
- "5411"
]
}
}
}
]
Returns information about the card spending limit control specified in the request URL.
Important This endpoint replaces the old version. However, please note that you have to set the api-version
header to the version you want (e.g., 2024-01-01
). If you do not specify an api-version
, then the API will return the older version of the response.
Successful result of the operation
The supplied partner identifier is invalid.
You are not authorized to perform this action.
The card spending limit control could not be found.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/card_controls/spending_limits/{id}(use%20api-version-header%20to%20consume%20this%20endpoint)'
{- "id": "7a911b90-0109-11ec-9a03-0242ac130003",
- "scope": "CARD",
- "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
- "origin": "SOLARISBANK",
- "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
- "limit": {
- "type": "MERCHANT_CATEGORY",
- "dimension": [
- "5411"
], - "period": "HOURLY",
- "amount": 10000,
- "count": 0
}, - "utilized_limit": {
- "amount": 10000,
- "count": 5
}
}
Deletes the card spending limit control specified in the request URL..
Important This endpoint replaces the old version. However, please note that you have to set the api-version
header to the version you want (e.g., 2024-01-01
). If you do not specify an api-version
, then the API will return the older version of the response.
No Content
The supplied partner identifier is invalid.
You are not authorized to perform this action.
Card controls spending limit not found
Internal server error.
curl -i -X DELETE \ 'https://api.solaris-sandbox.de/v1/card_controls/spending_limits/{id}(use%20api-version-header%20to%20consume%20this%20endpoint)'
[- {
- "id": "a95f2aaf-4e0c-4d49-8021-8a16a884ed86",
- "status": "400",
- "code": "build_pagination_headers_failure",
- "title": "Failed to build pagination headers.",
- "detail": "Cannot connect to database."
}
]
This endpoint confirms that a transaction marked as fraudulent was not actually fraudulent (i.e., the customer confirms that they made the transaction themselves or is otherwise aware of the transaction). Once you call this endpoint, fraud monitoring will be disabled for the card specified in the request URL for 10 minutes, and the transaction can be attempted again.
Successful result of the operation
An error occurred on the client side.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/cards/{card_id}/fraud_cases/{id}/whitelist'
{- "id": "154dca58bb1b5c8701039fa6514ffc66frdcs",
- "resolution": "WHITELISTED",
- "whitelisted_until": "2020-05-05T11:54:26Z"
}
This endpoint confirms to Solaris that a fraud case was indeed fraudulent. The card used to make the fraudulent transaction will be subsequently blocked. You should then redirect your customer to your customer support so that a replacement card can be issued.
Successful result of the operation
An error occurred on the client side.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
Unexpected error
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/cards/{card_id}/fraud_cases/{id}/confirm'
{- "id": "154dca58bb1b5c8701039fa6514ffc66frdcs",
- "resolution": "CONFIRMED"
}
This endpoint marks the 3DS authentication specified by the challenge_id
in the request URL as declined. The challenge must not have already expired.
The request was accepted and is being processed.
The challenge has already expired.
The resource could not be found.
Internal server error.
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/cards/3ds/{challenge_id}/decline' \ -H 'Content-Type: example'
{ }
Returns all card transactions associated with the card ID specified in the request URL. Use the filter parameters to narrow down the results according to your needs.
The operation was successful.
Request validation failed.
You are not authorized to perform this action.
Not Found.
Internal server error.
curl -i -X GET \ 'https://api.solaris-sandbox.de/v1/cards/{card_id}/transactions?filter%5Bcard_transaction_id%5D=string&filter%5Bcreated_at%5D%5Bmin%5D=2019-08-24T14%3A15%3A22Z&filter%5Bcreated_at%5D%5Bmax%5D=2019-08-24T14%3A15%3A22Z&filter%5Bpartner_id%5D=string&filter%5Biban%5D=string&filter%5Btransaction_key%5D=string&filter%5Bhashed_transaction_key%5D=string&filter%5Bindicators%5D=PREMATURELY_RESOLVED_RESERVATIONS_MATCHED&filter%5Bstatus%5D=ACTIVE&filter%5Bapproval_code%5D=string&filter%5Bmerchant_name%5D=string&filter%5Bmerchant_id%5D=string&filter%5Bcore_banking_reservation_id%5D=string&filter%5Bcore_banking_transaction_id%5D=string&filter%5Bamount%5D=0&filter%5Btransaction_amount%5D=0&filter%5Bdeclined%5D=true&page%5Bnumber%5D=0&page%5Bsize%5D=0'
[- {
- "id": null,
- "created_at": "2024-07-30T13:56:54+0000",
- "indicators": "PREMATURELY_RESOLVED_RESERVATIONS_MATCHED",
- "transaction_events": [
- {
- "source": "AUTHORIZATION",
- "acquirer_id": "12345678901",
- "amount": "-20000",
- "approval_code": "667163",
- "card_identifier": "503000477045",
- "card_transaction_id": "6e3cec44-755c-4e79-a3d7-b90890188289",
- "card_id": "4474c121fa1444286e42406543ca162bmcrd",
- "core_banking_reservation_id": "345dff59-229f-5972-bb8d-534feee37c2b",
- "core_banking_transaction_id": "fbcd8795-f129-5cb5-9759-222a7d56639a",
- "created_at": "2019-08-24T14:15:22Z",
- "iban": "DE112222222223333333333",
- "indicators": "string",
- "merchant_category_code": "0121",
- "merchant_id": "009399565",
- "merchant_name": "foo",
- "merchant_town": "bar",
- "origin_created_at": "2019-08-24T14:15:22Z",
- "origin_updated_at": "2019-08-24T14:15:22Z",
- "partner_id": "d0abb30f450a42d54bfef78d1e021e6bcpar",
- "pos_entry_mode": "UNKNOWN",
- "status": "SETTLED",
- "terminal_id": "1.1",
- "transaction_amount": "20000",
- "transaction_key": "100000000667163",
- "transaction_type": "PURCHASE",
- "interchange_fee_amount": "20000",
- "id": "4bf431a0-9718-4cb5-85ce-c0515e472968",
- "updated_at": "2019-08-24T14:15:22Z",
- "transaction_currency_code": "string",
- "fx_rate": "2.0",
- "merchant_country_code": "merchant_country_code",
- "acquirer_reference_number": "string",
- "transaction_country_code": "transaction_country_code",
- "card_holder_authentication_verification_value": "string",
- "token_provider": "APPLE",
- "token_type": "02",
- "token_number": "4113112380202020",
- "decline_reasons": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "message": "string"
}
]
}
]
}
]
This endpoint simulates a fraudulent transaction for the card specified in the request URL. The fraudulent transaction process will begin as a result.
This endpoint is only available on Sandbox.
Successful result of the operation
An error occurred on the client side.
You are not authorized to perform this action.
The resource could not be found.
Internal server error.
curl -i -X POST \ 'https://api.solaris-sandbox.de/v1/cards/{card_id}/test_fraud_cases'
{- "id": "a95f2aaf-4e0c-4d49-8021-8a16a884ed86",
- "status": "400",
- "code": "build_pagination_headers_failure",
- "title": "Failed to build pagination headers.",
- "detail": "Cannot connect to database."
}
This endpoint simulates a test 3DS transaction for the card_id specified in the request URL.
Calling this endpoint will begin the 3DS transaction process. The API will return a JSON schema containing the HTML for the 3DS challenge screen.
This endpoint is only available on Sandbox.
Successful result of the operation
Endpoint not available for production environment
The resource could not be found
Internal server error.
{- "merchant_name": "Merchant Name",
- "purchase_currency": "EUR",
- "purchase_amount": 1000
}
{- "html": "<html>...</html>"
}