List Checkout Attempts | PaymentKit

curl https://app.paymentkit.com/api/account_id/checkout-attempts/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "items": [
    {
      "id": "cae7f8d2-4b3a-4f9e-9a2b-1d2e3f4a5b6c",
      "checkout_session_id": "sess_01F8Z2X9Y7Q8W3E4R5T6U7I8O9",
      "state": "failed",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:45:00Z",
      "customer_id": "cus_9X8Y7Z6W5V4U3T2S1R0Q",
      "payment_intent_id": "pi_1F8Z2X9Y7Q8W3E4R5T6U7I8O",
      "cascade_tier": 1,
      "error_code": "card_declined",
      "error_message_for_customer": "Your card was declined. Please try another payment method.",
      "error_message_for_debug": "Processor declined the card due to insufficient funds.",
      "client_request_id": "req_1234567890abcdef",
      "submitted_customer_info": {
        "email": "jane.doe@example.com",
        "phone": "+14155552671"
      },
      "fraud_metadata": {
        "risk_score": 85,
        "risk_level": "high"
      },
      "attempt_metadata": {
        "ip_address": "203.0.113.42",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"
      },
      "invoice_id": "inv_01F8Z2X9Y7Q8W3E4R5T6U7I8O",
      "subscription_id": "sub_01F8Z2X9Y7Q8W3E4R5T6U7I8O",
      "payment_method_id": "pm_1F8Z2X9Y7Q8W3E4R5T6U7I8O",
      "card_checkout_attempt_id": "cca_01F8Z2X9Y7Q8W3E4R5T6U7I8O",
      "card_checkout_attempt_state": "processing",
      "processor_attempts": [
        {
          "processor_id": "proc_visa",
          "processor_name": "Visa",
          "charge_status": "declined",
          "setup_status": "completed",
          "charge_error_message": "Insufficient funds",
          "processor_attempt_id": "pa_1234567890abcdef",
          "payment_method_id": "pm_1F8Z2X9Y7Q8W3E4R5T6U7I8O"
        }
      ],
      "card_checkout_attempt": {
        "id": "cca_01F8Z2X9Y7Q8W3E4R5T6U7I8O",
        "state": "processing",
        "user_actions_count": 2,
        "max_user_actions_allowed": 3,
        "created_at": "2024-01-15T09:30:00Z",
        "updated_at": "2024-01-15T09:40:00Z",
        "available_processors": [
          "Visa",
          "Mastercard"
        ],
        "card_checkout_settings": {
          "require_cvv": true,
          "allow_save_card": false
        },
        "next_action_metadata": {
          "type": "redirect_to_url",
          "url": "https://secure3d.paymentprovider.com/authenticate"
        },
        "processor_attempts": [
          {
            "id": "pa_1234567890abcdef",
            "charge_status": "declined",
            "setup_status": "completed",
            "processor_id": "proc_visa",
            "processor_name": "Visa",
            "charge_error_code": "card_declined",
            "charge_error_message": "Insufficient funds",
            "processor_metadata": {
              "auth_code": "123456"
            },
            "processor_attempt_id": "pa_1234567890abcdef",
            "payment_method_id": "pm_1F8Z2X9Y7Q8W3E4R5T6U7I8O"
          }
        ],
        "three_ds_mode": "challenge",
        "three_ds_triggered": true,
        "three_ds_outcome": "authentication_failed"
      },
      "payment_method": {
        "id": "pm_1F8Z2X9Y7Q8W3E4R5T6U7I8O",
        "provider_type": "card",
        "name": "Jane Doe's Visa",
        "brand": "Visa",
        "last_four": "4242",
        "exp_month": 12,
        "exp_year": 2026,
        "country": "US",
        "fingerprint": "fp_abcdef1234567890",
        "meta": {
          "cardholder_name": "Jane Doe"
        }
      },
      "state_transitions": [
        {
          "id": "st_01F8Z2X9Y7Q8W3E4R5T6U7I8O",
          "entity_type": "checkout_attempt",
          "from_state": "pending",
          "to_state": "failed",
          "created_at": "2024-01-15T09:45:00Z",
          "context": {
            "reason": "card_declined"
          }
        }
      ]
    }
  ],
  "total": 1,
  "has_more": false
}

List checkout attempts with pagination.

Supports filtering by checkout_session_id via filter parameter.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

account_idstringRequired

Query parameters

expandlist of strings or nullOptional

Fields to expand: processor_attempts

limitintegerOptional1-100Defaults to 50

Number of items per page

offsetintegerOptional>=0Defaults to 0

Number of items to skip

filterstringOptionalDefaults to {}

Filter conditions as key-value pairs or advanced filter objects (JSON string)

sortBystring or nullOptional

Field to sort by

sortOrderintegerOptionalDefaults to -1

Sort order: 1 for ascending, -1 for descending

searchstring or nullOptional

Keyword-based search across multiple fields

Response

Successful Response

itemslist of objects

totalinteger

has_moreboolean

Authentication

Path parameters

Query parameters

Response

Errors