Card transaction

Retrieve one

Returns a single card transaction by id. Visible to admins, holders of the card_transactions_manage permission, or the cardholder the transaction belongs to.

The response includes the transaction's transaction_labels and the computed fields commission_id, type, amount_formatted, and target_amount_formatted. The internal embedding vector is never exposed.

Multi-provider note. Amounts are Cardda's own reconstruction across issuing partners (Slash, PLH, Pomelo, etc.): amount_in_clp is the CLP reconversion at settlement, and for some vendors the balance/decline context is derived from the vendor payload rather than a native field. Decline reasons surface in status_reason.

get/v1/card_transactions/{card_transaction_id}

Request

Base URL
https://api.cardda.com
URL
https://api.cardda.com/v1/card_transactions/{card_transaction_id}
Auth
HTTP bearer

Path parameters

card_transaction_idstring required

Card transaction id (vendor-prefixed string, often base64-encoded — not a UUID).

Parameters

#/paths/~1v1~1merchants/get/parameters/0 (unresolved $ref)

Response

The card transaction.

idstring

Vendor-prefixed transaction id (often base64-encoded; not a UUID).

user_idstring

Firebase user id of the cardholder.

vendor_card_idstring

Id of the VendorCard that incurred the transaction (vendor-prefixed string, not a UUID).

descriptionstring

merchant_namestring

cleaned_merchant_namestring nullable

Cardda-normalized merchant name (e.g. 'AMZN MKTP US' → 'Amazon').

merchant_image_urlstring nullable

merchant_idstring uuid nullable

Lifecycle status of the transaction.

What sort of monetary movement the row represents.

typestring

STI subclass — the issuing vendor that produced the transaction.

amount_centsinteger

Transaction amount in the merchant currency, in minor units (e.g. cents). Spends are negative (purchase, fee, fx_fee, allocation); refunds/reversals/allocation_release are positive.

amount_in_clpinteger

Amount of the transaction in CLP at settlement time. Follows the same sign convention as amount_cents (spends negative, refunds positive).

amount_in_limit_currencyinteger nullable

Amount converted to the card's limit_currency.

currencystring

Merchant currency in upper-case ISO-4217 (e.g. USD, CLP).

exchange_ratestring

migratedboolean nullable

invoice_idstring uuid nullable

UUID of a legacy Invoice row (internal billing record kept for backwards compatibility). Not a FiscalInvoice / SII DTE id — fiscal invoice ids use the composite <rut>-<document_type>-<number> string format and are exposed via GET /v1/fiscal_invoices, not via this field.

status_reasonstring nullable

Reason of the current transaction status

commission_idstring uuid nullable

UUID of the linked commission row, when the transaction accrued a Cardda commission (computed field).

target_amount_centsinteger

Settled amount in the company's accounting currency, in minor units. Follows the same sign convention as amount_cents (spends negative, refunds positive).

target_currencystring

Currency the company sees the transaction in (the user's preferred accounting currency), in upper-case ISO-4217.

amount_formattedstring nullable

UI-ready formatted amount including currency.

target_amount_formattedstring nullable

UI-ready formatted settled amount including currency.

commentsstring nullable

Free-form internal notes attached by the company.

superseding_transaction_idstring nullable

When a pending transaction is replaced by the final one, the new id.

superseding_reasonstring nullable

Why the transaction was superseded.

completed_atstring date-time nullable

When the transaction was captured/cleared.

settled_atstring date-time nullable

When the transaction reached final settlement.

company_idstring uuid

created_atstring date-time

updated_atstring date-time

Example response

{
  "id": "VHJhbnNhY3Rpb246MTIzNDU2",
  "user_id": "U2MGkNZT6zNPKtB85OpJi9SjFvG2",
  "vendor_card_id": "Q2FyZDoxMDIwNjQ5Mw==",
  "description": "Cargo de GOOGLE ADS",
  "merchant_name": "GOOGLE ADS",
  "cleaned_merchant_name": "Google",
  "type": "PomeloTransaction",
  "amount_cents": -45000,
  "amount_in_clp": -366287,
  "currency": "USD",
  "exchange_rate": "813.9702",
  "migrated": true,
  "status_reason": "card_limit",
  "target_amount_cents": -366287,
  "target_currency": "CLP",
  "amount_formatted": "USD 99.00",
  "target_amount_formatted": "CLP 9.270.000",
  "card": {
    "id": "Q2FyZDoxMDIwNjQ5Mw==",
    "user_id": "U2MGkNZT6zNPKtB85OpJi9SjFvG2",
    "type": "PomeloCard",
    "name": "AWS",
    "spending_control_strategy": "allocation_based",
    "last4": "4163",
    "status_preference": "inactive",
    "migrated": true,
    "limit_amount": {
      "amount": "3000.0",
      "formatted": "$3.000 CLP",
      "cents": "3000.0",
      "currency_iso": "CLP"
    },
    "limit_interval": "daily",
    "limit_amount_preference": {
      "amount": "3000.0",
      "formatted": "$3.000 CLP",
      "cents": "3000.0",
      "currency_iso": "CLP"
    },
    "allocated_amount": {
      "amount": "3000.0",
      "formatted": "$3.000 CLP",
      "cents": "3000.0",
      "currency_iso": "CLP"
    },
    "allocated_amount_preference": {
      "amount": "3000.0",
      "formatted": "$3.000 CLP",
      "cents": "3000.0",
      "currency_iso": "CLP"
    },
    "recurring_allocation_amount_cents": 50000,
    "remaining_balance": "2000.0",
    "spent": 472025,
    "company_expendable_balance_in_limit_currency": "3200000.0",
    "spent_in_interval_with_limit_currency": 472025,
    "vendor_max_allocation": {
      "amount": "3000.0",
      "formatted": "$3.000 CLP",
      "cents": "3000.0",
      "currency_iso": "CLP"
    },
    "preference_restricted_spendable": "2000.0",
    "spent_in_interval": 472025,
    "spent_in_vendor_interval": 472025
  },
  "merchant": {
    "id": "87128e7e-d774-4e2d-b4b5-5d20c7ebe682",
    "name": "Amazon",
    "image_url": "https://logos.cardda.com/amazon.png"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.