latestOpenAPI 3.0.12026-08-104068226.2 KB

a772504dcc9e

Card transactions

Index card transactions

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.

get/v1/cards/{card_id}/transactions

Path parameters

card_idstring uuid required

ID of the card.

Query parameters

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]'PREMATURELY_RESOLVED_RESERVATIONS_MATCHED' | 'RESERVED_LESS_THAN_SETTLED' | 'SETTLED_BUT_NOT_RESERVED_BEFORE'

Filter the results by transaction indicator.

filter[status]'ACTIVE' | 'EXPIRED' | 'INITIATED' | 'PROCESSED' | 'RESOLVED' | 'REVERSED' | 'SETTLED'

Filter the results by transaction status.

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

Specifies the number of results pages to return.

page[size]integer

Specifies the number of entries on each results page.

Response

The operation was successful.

idstring uuid

ID of the transaction.

created_atstring date-time

UTC timestamp from when the transaction was created.

indicators'PREMATURELY_RESOLVED_RESERVATIONS_MATCHED' | 'RESERVED_LESS_THAN_SETTLED' | 'SETTLED_BUT_NOT_RESERVED_BEFORE' nullable

Indicator related to the transaction.

Example response

[
  {
    "id": "4bf431a0-9718-4cb5-85ce-c0515e472968",
    "created_at": "2024-07-30T13:56:54+0000",
    "transaction_events": [
      {
        "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",
        "iban": "DE112222222223333333333",
        "merchant_category_code": "0121",
        "merchant_id": "009399565",
        "merchant_name": "foo",
        "merchant_town": "bar",
        "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",
        "fx_rate": "2.0",
        "merchant_country_code": "merchant_country_code",
        "transaction_country_code": "transaction_country_code",
        "token_provider": "APPLE",
        "token_type": "02",
        "token_number": "4113112380202020"
      }
    ]
  }
]