---
title: "Add the card of a finished setup to the organization's cards in this mode, as the default card (kept for older clients: `POST /v1/payment-methods/confirm` chooses). Every automatic charge still due is then retried on it shortly after, in the background; a case on hold for a declined card continues once its costs are paid. Safe to repeat. 409 `setup_incomplete` while the card is not saved yet; in live mode, 409 `live_unavailable` until live full-service cases are switched on"
method: POST
path: "/v1/payment-method/confirm"
---

# Add the card of a finished setup to the organization's cards in this mode, as the default card (kept for older clients: \`POST /v1/payment-methods/confirm\` chooses). Every automatic charge still due is then retried on it shortly after, in the background; a case on hold for a declined card continues once its costs are paid. Safe to repeat. 409 \`setup_incomplete\` while the card is not saved yet; in live mode, 409 \`live_unavailable\` until live full-service cases are switched on

`POST /v1/payment-method/confirm`

## Request

- Base URL: `https://api.evictionsapi.com`
- URL: `https://api.evictionsapi.com/v1/payment-method/confirm`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- object
  - `sessionId` string, required

## Response `200`

The saved card.

- PaymentMethod: The default card for the automatic charges of full-service cases, in the key's mode, as the older `/v1/payment-method` routes show it: its brand and last four only. `failed`: the card was declined, and the cases waiting on a payment stay on hold until a card that works is saved.
  - `brand` string, nullable, required
  - `lastFour` string, nullable, required
  - `status` 'usable' | 'failed', required

## Other responses

- `400`: The request is invalid.
- `401`: The credential is missing or invalid.
- `403`: The credential is not allowed to do this (`forbidden`). For a signed-in session: `permission_denied`, the person's role in the organization lacks the permission this needs (ask an owner); `no_organization`, the person belongs to no organization yet (start one with `POST /v1/me/organizations` or accept an invitation).
- `404`: Not found.
- `409`: The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.
- `422`: The case did not pass a check.

---

[API](https://skmtc.dev/evictionsapi/apis/evictions-api.md) · [All operations](https://skmtc.dev/evictionsapi/apis/evictions-api/llms.txt) · [OpenAPI document](https://skmtc.dev/evictionsapi/apis/evictions-api/revisions/28459213a1a3?raw)