Card

Get card financial transaction

Changed on

Get the card financial transaction for the provided token.

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

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/cards/{card_token}/financial_transactions/{financial_transaction_token}
  • Auth
    API key in header Authorization

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

  • 9798275dc379Revision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

  • dc3c4d014332Revision changes
    • warning

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

    • warning

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