---
title: "Save a card for agent purchases: a Stripe Checkout in setup mode on the account customer (30 per account per hour); the webhook stores the method it saved"
method: POST
path: "/v1/account/billing/payment-method/setup-sessions"
---

# Save a card for agent purchases: a Stripe Checkout in setup mode on the account customer (30 per account per hour); the webhook stores the method it saved

`POST /v1/account/billing/payment-method/setup-sessions`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/account/billing/payment-method/setup-sessions`
- Auth: API key in cookie `rove_session`

## Response `201`

Successful response (Cache-Control: no-store)

- object
  - `url` string, required: A Stripe Checkout (mode setup) that saves a card for agent purchases; returns to the billing page with ?setup=done.

## Other responses

- `401`: RFC 7807 owner-session-required: sign in at owner_action_url
- `403`: RFC 7807 owner-origin-refused (mutations only)
- `429`: RFC 7807 purchase-rate-limited; Retry-After
- `503`: RFC 7807 billing-unavailable; Retry-After: 30, retry same_key

---

[API](https://skmtc.dev/roveapi/apis/rove-api.md) · [All operations](https://skmtc.dev/roveapi/apis/rove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roveapi/apis/rove-api/revisions/0e5d69bde586?raw)