Retrieve

Get card transaction

get/v1/transactions/{transaction_token}

Get a specific card transaction. All amounts are in the smallest unit of their respective currency (e.g., cents for USD).

Path Parameters

transaction_tokenstring

formatuuid

Returns

Request example Request

curl https://api.lithic.com/v1/transactions/$TRANSACTION_TOKEN \
    -H "Authorization: $LITHIC_API_KEY"

200 Example

{
  "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "account_token": "bd5e5649-1be8-4117-9bc5-3268258d1417",
  "acquirer_fee": 0,
  "acquirer_reference_number": "12345678987654321234567",
  "amount": 1000,
  "amounts": {
    "cardholder": {
      "amount": -1000,
      "conversion_rate": "1.000000",
      "currency": "USD"
    },
    "hold": {
      "amount": 0,
      "currency": "USD"
    },
    "merchant": {
      "amount": -1000,
      "currency": "USD"
    },
    "settlement": {
      "amount": -1000,
      "currency": "USD"
    }
  },
  "authorization_amount": 1000,
  "authorization_code": "123456",
  "avs": {
    "address": "address",
    "zipcode": "zipcode"
  },
  "card_token": "19c22c47-7a75-43ee-9891-595419830f7e",
  "cardholder_authentication": {
    "3ds_version": "2",
    "acquirer_exemption": "NONE",
    "authentication_result": "SUCCESS",
    "decision_made_by": "LITHIC_RULES",
    "liability_shift": "3DS_AUTHENTICATED",
    "three_ds_authentication_token": "a6e372d0-b40a-43eb-b0d1-4e1aebef5875",
    "verification_attempted": "NONE",
    "verification_result": "FRICTIONLESS",
    "authentication_method": "FRICTIONLESS"
  },
  "created": "2023-09-26T21:14:28.637Z",
  "merchant": {
    "acceptor_id": "333301802529120",
    "acquiring_institution_id": "191231",
    "city": "NEW YORK",
    "country": "USA",
    "descriptor": "COFFEE SHOP",
    "mcc": "5812",
    "state": "NY"
  },
  "merchant_amount": 1000,
  "merchant_authorization_amount": 1000,
  "merchant_currency": "USD",
  "network": "MASTERCARD",
  "network_risk_score": 0,
  "pos": {
    "entry_mode": {
      "card": "NOT_PRESENT",
      "cardholder": "DEFERRED_BILLING",
      "pan": "AUTO_ENTRY",
      "pin_entered": true
    },
    "terminal": {
      "attended": true,
      "card_retention_capable": true,
      "on_premise": true,
      "operator": "ADMINISTRATIVE",
      "partial_approval_capable": true,
      "pin_capability": "CAPABLE",
      "type": "ADMINISTRATIVE",
      "acceptor_terminal_id": "acceptor_terminal_id"
    }
  },
  "result": "APPROVED",
  "settled_amount": 1000,
  "status": "SETTLED",
  "token_info": {
    "wallet_type": "APPLE_PAY"
  },
  "updated": "2023-09-26T21:14:28.637Z",
  "events": [
    {
      "token": "0c2adae9-f535-4505-8c35-421dad9bd0b6",
      "amount": 1000,
      "amounts": {
        "cardholder": {
          "amount": 1000,
          "conversion_rate": "1.000000",
          "currency": "USD"
        },
        "merchant": {
          "amount": 1000,
          "currency": "USD"
        },
        "settlement": {
          "amount": 1000,
          "conversion_rate": "1.000000",
          "currency": "USD"
        }
      },
      "created": "2023-09-26T21:14:28.637Z",
      "detailed_results": [
        "APPROVED"
      ],
      "effective_polarity": "DEBIT",
      "network_info": {
        "acquirer": {
          "acquirer_reference_number": "acquirer_reference_number",
          "retrieval_reference_number": "retrieval_reference_number"
        },
        "amex": {
          "original_transaction_id": "original_transaction_id",
          "transaction_id": "transaction_id"
        },
        "mastercard": {
          "banknet_reference_number": "banknet_reference_number",
          "original_banknet_reference_number": "original_banknet_reference_number",
          "original_switch_serial_number": "original_switch_serial_number",
          "switch_serial_number": "switch_serial_number"
        },
        "visa": {
          "original_transaction_id": "original_transaction_id",
          "transaction_id": "transaction_id"
        }
      },
      "result": "APPROVED",
      "rule_results": [
        {
          "auth_rule_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "explanation": "explanation",
          "name": "name",
          "result": "APPROVED"
        }
      ],
      "type": "CLEARING",
      "network_specific_data": {
        "mastercard": {
          "ecommerce_security_level_indicator": "xxx",
          "on_behalf_service_result": [
            {
              "result_1": "x",
              "result_2": "x",
              "service": "xx"
            }
          ],
          "transaction_type_identifier": "xxx"
        },
        "visa": {
          "business_application_identifier": "xx"
        }
      }
    }
  ]
}