Sign in
Card

Get card financial transaction

Get the card financial transaction for the provided token.

get/v1/cards/{card_token}/financial_transactions/{financial_transaction_token}

Path parameters

card_tokenstring uuid required
financial_transaction_tokenstring uuid required

Globally unique identifier for financial transaction token.

Response

OK

category'ACH' | 'CARD' | 'INTERNAL' | 'TRANSFER' required

Status types:

  • CARD - Issuing card transaction.
  • ACH - Transaction over ACH.
  • INTERNAL - Transaction for internal adjustment.
  • TRANSFER - Internal transfer of funds between financial accounts in your program.
createdstring date-time required

Date and time when the financial transaction first occurred. UTC time zone.

currencystring required

3-character alphabetic ISO 4217 code for the settling currency of the transaction.

descriptorstring required

A string that provides a description of the financial transaction; may be useful to display to users.

pending_amountinteger required

Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees.

The value of this field will go to zero over time once the financial transaction is settled.

result'APPROVED' | 'DECLINED' required

APPROVED transactions were successful while DECLINED transactions were declined by user, Lithic, or the network.

settled_amountinteger required

Amount of the transaction that has been settled in the currency's smallest unit (e.g., cents), including any acquirer fees. This may change over time.

status'DECLINED' | 'EXPIRED' | 'PENDING' | 'RETURNED' | 'SETTLED' | 'VOIDED' required

Status types:

  • DECLINED - The transaction was declined.
  • EXPIRED - The authorization as it has passed its expiration time. Card transaction only.
  • PENDING - The transaction is expected to settle.
  • RETURNED - The transaction has been returned.
  • SETTLED - The transaction is completed.
  • VOIDED - The transaction was voided. Card transaction only.
tokenstring uuid required

Globally unique identifier.

updatedstring date-time required

Date and time when the financial transaction was last updated. UTC time zone.

Changes

Changed in 4 of the 83 revisions of this API.9

  • bfc64a57040c3See the full diff
    • ●

      added the new STABLECOIN_INITIATED enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new STABLECOIN_REJECTED enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new STABLECOIN_SENT enum value to the // response property for the response status

      response-property-enum-value-added

  • b169ec56c4693See the full diff
    • ●

      added the new STABLECOIN_RECEIVED enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new STABLECOIN_REVIEWED enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new STABLECOIN_SETTLED enum value to the // response property for the response status

      response-property-enum-value-added

  • 8ce09fc83c5a2See the full diff
    • ●

      added the new BANK_PROGRAM_TRANSFER enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new LITHIC_PROGRAM_TRANSFER enum value to the // response property for the response status

      response-property-enum-value-added

  • fac001c633731See the full diff
    • ●

      added the new ACCOUNT_TO_ACCOUNT enum value to the // response property for the response status

      response-property-enum-value-added