---
title: "Create or reuse the prospect's Stripe card-setup session"
method: POST
path: "/client-onboarding/public/enrollments/{token}/payment-method-session"
tags: ["Client Onboarding"]
---

# Create or reuse the prospect's Stripe card-setup session

`POST /client-onboarding/public/enrollments/{token}/payment-method-session`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/client-onboarding/public/enrollments/{token}/payment-method-session`
- Auth: none required

Returns a connected-account Stripe Checkout URL that saves a reusable card without charging it. The operation is token-authorized, rate-limited, and intentionally unavailable through MCP because an agent must not enter payment credentials for a prospect.

## Path parameters

- `token` string, required

## Response `200`

Stripe Checkout setup URL

- PublicClientOnboardingPaymentMethodSession
  - `checkoutUrl` string, uri, required

## Other responses

- `409`: The enrollment cannot start card setup in its current state
- `410`: The resume token is invalid or expired
- `429`: Rate limit exceeded
- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)
