Skip to content
/Card transactions

Card creation & servicing (1.0)

Download OpenAPI description
cards.json
cards.yaml
Languages
Servers
Mock Server

https://docs.solarisgroup.com/_mock/api-reference/digital-banking/cards/

Cards servicing

Operations

Encrypted PIN Change

Operations

Card spending controls

Operations

Card transactions

Operations

Allow a transaction that was marked as fraudulent

Request

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.

Path
card_idstringrequired
idstringrequired
No request payload

Responses

Successful result of the operation

Bodyapplication/json
idstring

ID of the fraud case.

Example: "154dca58bb1b5c8701039fa6514ffc66frdcs"
resolutionstring

The current status of the fraud case.

Enum"CONFIRMED""PENDING""TIMEOUT""WHITELISTED"
Example: "WHITELISTED"
whitelisted_untilstring

Timestamp indicating how long transactions will be whitelisted for the given card (i.e., 10 minutes after calling the endpoint).

Example: "2020-05-05T11:54:26Z"
Response
application/json
{
  "id": "154dca58bb1b5c8701039fa6514ffc66frdcs",
  "resolution": "WHITELISTED",
  "whitelisted_until": "2020-05-05T11:54:26Z"
}

Confirm a fraud case

Request

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.

Path
card_idstringrequired
idstringrequired
No request payload

Responses

Successful result of the operation

Bodyapplication/json
idstring

ID of the fraud case.

Example: "154dca58bb1b5c8701039fa6514ffc66frdcs"
resolutionstring

The current status of the fraud case.

Enum"CONFIRMED""PENDING""TIMEOUT""WHITELISTED"
Example: "CONFIRMED"
Response
application/json
{
  "id": "154dca58bb1b5c8701039fa6514ffc66frdcs",
  "resolution": "CONFIRMED"
}

Decline 3DS authentication

Request

This endpoint marks the 3DS authentication specified by the challenge_id in the request URL as declined. The challenge must not have already expired.

Path
challenge_idstringrequired
Bodyexample
No request payload

Responses

The request was accepted and is being processed.

Bodyapplication/json
object
Response
application/json
{}

Index card transactions

Request

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.

Path
card_idstring(uuid)required

ID of the card.

Query
filter[card_transaction_id]string

Filter the results by card transaction ID. (One value)

filter[created_at][min]string(date-time)

Filter the results by the date/time when the transaction was created (from a given date/time value in UTC format).

filter[created_at][max]string(date-time)

Filter the results by the date/time when the transaction was created (until a given date/time value in UTC format).

filter[partner_id]string

Filter the results by partner ID.

filter[iban]string

Filter the results by associated IBAN.

filter[transaction_key]string

Filter the results by the transaction key.

filter[hashed_transaction_key]string

Filter the results by the hashed transaction key.

filter[indicators]string

Filter the results by transaction indicator.

Enum"PREMATURELY_RESOLVED_RESERVATIONS_MATCHED""RESERVED_LESS_THAN_SETTLED""SETTLED_BUT_NOT_RESERVED_BEFORE"
filter[status]string

Filter the results by transaction status.

Enum"ACTIVE""EXPIRED""INITIATED""PROCESSED""RESOLVED""REVERSED""SETTLED"
filter[approval_code]string

Filter the results by approval code.

filter[merchant_name]string

Filter the results by merchant name.

filter[merchant_id]string

Filter the results by merchant ID.

filter[core_banking_reservation_id]string

Filter the results by core banking reservation ID.

filter[core_banking_transaction_id]string

Filter the results by core banking transaction ID.

filter[amount]integer

Filter the results by the amount deducted from the customer's account.

filter[transaction_amount]integer

Filter the results by the transaction amount.

filter[declined]boolean

Return only declined transactions.

page[number]integer(int32)

Specifies the number of results pages to return.

page[size]integer(int32)

Specifies the number of entries on each results page.

No request payload

Responses

The operation was successful.

Bodyapplication/jsonArray [
idstring(uuid)

ID of the transaction.

Example: null
created_atstring(date-time)

UTC timestamp from when the transaction was created.

Example: "2024-07-30T13:56:54+0000"
indicatorsstring or null

Indicator related to the transaction.

Enum"PREMATURELY_RESOLVED_RESERVATIONS_MATCHED""RESERVED_LESS_THAN_SETTLED""SETTLED_BUT_NOT_RESERVED_BEFORE"
transaction_eventsArray of objects(TransactionEventDto)

Array of events related to the transaction.

]
Response
application/json
[
  {
    "id": null,
    "created_at": "2024-07-30T13:56:54+0000",
    "indicators": "PREMATURELY_RESOLVED_RESERVATIONS_MATCHED",
    "transaction_events": [ … ]
  }
]

Card transactions simulation

Operations

Card Delivery Tracking API

Operations