Retrieve a Checkout Session

​

Retrieve details of a checkout session by its id.

Path Parameters
  • id
    Type: string
    max length:  
    200
    required
Query Parameters
  • expand
    Type: array string[]
Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/checkouts/{id}
curl 'https://api.paypercut.io/v1/checkouts/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "currency": {
    "iso": "usd",
    "scale": 2
  },
  "description": "string",
  "mode": "payment",
  "ui_mode": "hosted",
  "cancel_url": "string",
  "success_url": "string",
  "return_url": "string",
  "payment_method_types": [
    "string"
  ],
  "submit_type": "auto",
  "wallet_options": {
    "apple_pay": {
      "display": "auto"
    },
    "google_pay": {
      "display": "auto"
    }
  },
  "client_reference_id": "string",
  "client_customer_id": "string",
  "expires_at": null,
  "line_items": [
    {
      "quantity": 2,
      "price_data": {
        "active": true,
        "billing_scheme": "per_unit",
        "created": 1,
        "currency": "string",
        "livemode": true,
        "lookup_key": null,
        "product": "01K755J9SV2364REVHB915Z2FW",
        "product_data": {
          "active": true,
          "name": "string",
          "description": "string",
          "unit_label": "string",
          "id": "string"
        },
        "recurring": {
          "interval": "day",
          "interval_count": 1,
          "meter": null,
          "usage_type": "licensed"
        },
        "type": "one_time",
        "unit_amount": null,
        "unit_amount_decimal": null,
        "id": "string"
      },
      "metadata": {
        "additionalProperty": "string"
      }
    }
  ],
  "payment_intent_data": {
    "amount": 100,
    "capture_method": "automatic",
    "on_behalf_of": "string",
    "statement_descriptor": null,
    "setup_future_usage": "off_session",
    "payment_method": "01K688H80Z3199KETHDJ4ZAFPS",
    "customer": {
      "email": null,
      "name": null,
      "phone": null,
      "preferred_locales": [
        "string"
      ],
      "address": {
        "city": null,
        "country": null,
        "line1": null,
        "line2": null,
        "postal_code": null,
        "state": null
      },
      "invoice_settings": {
        "default_payment_method": "01K688H80Z3199KETHDJ4ZAFPS"
      },
      "created": "2026-04-02T14:45:59.065Z",
      "livemode": true,
      "id": "string",
      "payment_methods": [
        {
          "type": "card",
          "card": {
            "cardholder_name": "[Max Depth Exceeded]",
            "brand": "[Max Depth Exceeded]",
            "country": "[Max Depth Exceeded]",
            "issuer": "[Max Depth Exceeded]",
            "display_brand": "[Max Depth Exceeded]",
            "exp_month": "[Max Depth Exceeded]",
            "exp_year": "[Max Depth Exceeded]",
            "fingerprint": "[Max Depth Exceeded]",
            "funding": "[Max Depth Exceeded]",
            "segment": "[Max Depth Exceeded]",
            "iin": "[Max Depth Exceeded]",
            "last4": "[Max Depth Exceeded]",
            "wallet": "[Max Depth Exceeded]",
            "three_d_secure_usage": "[Max Depth Exceeded]"
          },
          "billing_details": {
            "email": "[Max Depth Exceeded]",
            "name": "[Max Depth Exceeded]",
            "phone": "[Max Depth Exceeded]",
            "address": "[Max Depth Exceeded]"
          },
          "metadata": "[Max Depth Exceeded]",
          "customer": "string",
          "id": "string",
          "livemode": true,
          "created": "2026-04-02T14:45:59.065Z"
        }
      ]
    }
  },
  "saved_payment_method_options": {
    "payment_method_save": "disabled"
  },
  "metadata": {
    "additionalProperty": "string"
  },
  "after_completion": {
    "type": "redirect",
    "redirect": {
      "url": "https://example.com"
    },
    "hosted": {
      "custom_message": "string"
    }
  },
  "locale": "auto",
  "customer": null,
  "customer_email": null,
  "customer_creation": "always",
  "id": "21210021c2855007efa2d657018",
  "amount_total": 100,
  "url": "https://www.example.com",
  "payment_intent": "01K755J9SY55CS04SQ3JX1NX36",
  "setup_intent": "01K755J9SY55CS04SQ3JX1NX36",
  "payment_link": "01K755J9SV2364REVHB915Z2FW",
  "payment_status": "no_payment_required",
  "status": "complete",
  "next_action": {
    "redirect_to_url": {
      "return_url": null,
      "url": null
    },
    "type": "string",
    "three_d_secure": {
      "flow": "frictionless",
      "status_url": "https://api.yourco.com/v1/payment_intents/pi_123",
      "return_url": null,
      "message": {
        "allowed_origins": [
          "https://merchant.example.com"
        ]
      },
      "hint": {
        "scheme": "visa",
        "version": "2.2.0"
      },
      "idempotency_key": "string"
    }
  },
  "livemode": true,
  "billing_address_collection": "auto"
}

Checkout details