List card transactions
Changed onList card transactions. All amounts are in the smallest unit of their respective currency (e.g., cents for USD) and inclusive of any acquirer fees.
Request
- Base URLhttps://sandbox.lithic.com
- URLhttps://sandbox.lithic.com/v1/transactions
- AuthAPI key in header Authorization
Query parameters
Filters for transactions associated with a specific account.
Filters for transactions associated with a specific card.
Filters for transactions using transaction result field. Can filter by APPROVED, and DECLINED.
Filters for transactions using transaction status field.
Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.
Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.
A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item.
Page size (for pagination).
A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item.
Response
OK
Example response
{
"data": [
{
"account_token": "db3942f0-0627-4887-a190-1ea83b46d091",
"acquirer_fee": 0,
"acquirer_reference_number": null,
"amount": 1800,
"amounts": {
"cardholder": {
"amount": 0,
"conversion_rate": "1.000000",
"currency": "USD"
},
"hold": {
"amount": -1800,
"currency": "USD"
},
"merchant": {
"amount": 0,
"currency": "USD"
},
"settlement": {
"amount": 0,
"currency": "USD"
}
},
"authorization_amount": 1800,
"authorization_code": "071471",
"avs": {
"zipcode": "95006",
"address": "123 Evergreen Terrace"
},
"card_token": "aac502f9-aecc-458a-954e-4bcf6edb6123",
"cardholder_authentication": {
"liability_shift": "3DS_AUTHENTICATED",
"authentication_result": "SUCCESS",
"authentication_method": "FRICTIONLESS",
"three_ds_authentication_token": "fc60d37d-95f7-419c-b628-dd9fbf9d80d0",
"decision_made_by": "NETWORK"
},
"created": "2023-08-03T18:42:30Z",
"events": [
{
"amount": 1800,
"amounts": {
"cardholder": {
"amount": 1800,
"conversion_rate": "1.000000",
"currency": "USD"
},
"merchant": {
"amount": 1800,
"currency": "USD"
},
"settlement": null
},
"created": "2023-08-03T18:42:30Z",
"detailed_results": [
"APPROVED"
],
"effective_polarity": "DEBIT",
"network_info": {
"acquirer": {
"acquirer_reference_number": null,
"retrieval_reference_number": "064386558597"
},
"amex": null,
"mastercard": {
"banknet_reference_number": "U1HSCJ",
"switch_serial_number": null,
"original_banknet_reference_number": null,
"original_switch_serial_number": null
},
"visa": null
},
"result": "APPROVED",
"rule_results": [],
"token": "bbbf1e86-322d-11ee-9779-00505685a123",
"type": "AUTHORIZATION"
}
],
"financial_account_token": "a3b113e8-01fe-42d3-b900-b9adf3f15496",
"merchant": {
"acceptor_id": "452322000053360",
"acquiring_institution_id": "333301802529120",
"city": "gosq.com",
"country": "USA",
"descriptor": "SQ *SOMA EATS",
"mcc": "5812",
"state": "CA",
"postal_code": "94107",
"street_address": null,
"phone_number": null
},
"service_location": null,
"merchant_amount": 1800,
"merchant_authorization_amount": 1800,
"merchant_currency": "USD",
"network": "MASTERCARD",
"network_risk_score": 5,
"pos": {
"entry_mode": {
"card": "NOT_PRESENT",
"cardholder": "NOT_PRESENT",
"pan": "ECOMMERCE",
"pin_entered": false
},
"terminal": {
"attended": false,
"card_retention_capable": false,
"on_premise": false,
"operator": "UNKNOWN",
"partial_approval_capable": false,
"pin_capability": "NOT_CAPABLE",
"type": "UNKNOWN"
}
},
"result": "APPROVED",
"settled_amount": 0,
"status": "PENDING",
"tags": {
"risk-level": "high"
},
"token": "c30c2182-1e69-4e0d-b40f-eec0d2a19123",
"token_info": {
"wallet_type": "APPLE_PAY"
},
"updated": "2023-08-03T18:42:30Z"
}
],
"has_more": false
}Changes
- breaking
added
subschema #1to the//response propertyoneOflist for the response status - breaking
the
//response's property type changed fromobjectto no type for status - breaking
removed the required property
///from the response with the status - breaking
removed the required property
///from the response with the status
- breaking
- breaking
the response property
////became nullable for the status - warning
added the new
ALLPOINTenum value to the//response property for the response status - warning
added the new
CREDIT_CARDenum value to the////response property for the response status - warning
added the new
DEFAULTenum value to the////response property for the response status - warning
added the new
undefinedenum value to the////response property for the response status - info
added 'propertyNames' constraint to the
//response property for the status
- breaking