Sign in

v1

latestOpenAPI 3.1.02026-07-2684271522.2 KB
Checkout Sessions

Reauth Checkout Session

Re-authorizes the payment on a Checkout Session whose authorization has expired or been fully captured, creating a new payment intent so the funds can be captured again. Use amount_override to authorize a different amount than the session total; otherwise the remaining authorizable amount is used. For split carts, the eligible and non-eligible buckets are each re-authorized as needed.

post/v1/checkout/sessions/{id}/reauth

Path parameters

idstring required
Example:fcs_01J9XR8M3K7VZ8N2YB4WJ6T0RA

Query parameters

expandstring

Comma-separated list of related objects to expand in the response.

Comma-separated list of related objects to expand in the response.

Request body

Example request

{
  "checkout_session": {
    "amount_override": 2500
  }
}

Response

An envelope wrapping a single checkout session object.

Example response

{
  "checkout_session": {
    "allow_promotion_codes": false,
    "amount_total": 2500,
    "amount_subtotal": 2500,
    "amount_received": 2500,
    "amount_refunded": 2500,
    "amount_disputed": 2500,
    "cancel_url": "https://example.com",
    "captures": [],
    "disputes": [],
    "capture_method": "automatic",
    "checkout_session_id": "fcs_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "client_reference_id": "example_value",
    "created_at": 2500,
    "defaults": {},
    "expires_at": 2500,
    "invoice": "fin_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "hsa_fsa_eligible": false,
    "letter_of_medical_necessity_required": false,
    "metadata": {
      "order_id": "8842",
      "channel": "shopify"
    },
    "mode": "payment",
    "origin": "shopify",
    "redirect_url": "https://example.com",
    "refunds": [],
    "setup_intent": "fseti_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "shipping_options": {},
    "shipping_address_collection": false,
    "shipping_details": {},
    "status": "open",
    "success_url": "https://example.com",
    "fees": [
      {}
    ],
    "custom_text": {},
    "subscription_data": {},
    "tax_rate": {},
    "tax_calculation_mode": "exclusive",
    "test_mode": false,
    "total_details": {
      "amount_discount": 2500,
      "amount_tax": 2500,
      "amount_shipping": 2500,
      "amount_iias": 2500,
      "amount_vision": 2500,
      "amount_prescription": 2500,
      "amount_service": 2500,
      "amount_fee": 2500
    },
    "visit_type": "cbtSleep",
    "setup_future_use": "on_session",
    "payment_method_options": {},
    "platform_fees": {}
  }
}