> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.getsinbad.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getsinbad.com/_mcp/server.

# Saved payment accounts

> Manage a customer's fiat payment accounts using the fields the catalog defines.

A saved payment account is a customer-owned fiat account for one catalog payment method. The catalog decides which fields an account needs, so build your form from the catalog rather than hard-coding fields.

## Read the catalog

[`GET /v1/payment-methods/catalog`](https://docs.getsinbad.com/api-reference/reference-data/list-payment-method-catalog) returns the payment methods, each with a `paymentMethodId`. Its `requiredFields` schema defines the account fields and the field that identifies an account. [`GET /v1/payment-methods/catalog/{paymentMethodId}/currencies`](https://docs.getsinbad.com/api-reference/reference-data/list-payment-method-currencies) shows which currencies each method supports.

## Create and list accounts

Create an account with [`POST /v1/me/payment-methods`](https://docs.getsinbad.com/api-reference/payment-accounts/create-saved-payment-method) and list the customer's accounts with [`GET /v1/me/payment-methods`](https://docs.getsinbad.com/api-reference/payment-accounts/list-saved-payment-methods). A saved account's ID is different from the catalog's payment method ID, so keep the two distinct. Offer search needs an active saved account that matches the catalog payment method.

## Update or remove an account

[`PATCH /v1/me/payment-methods/{id}`](https://docs.getsinbad.com/api-reference/payment-accounts/update-saved-payment-method) can change the label and whether the account is active. The catalog method and the identifying value cannot change. To remove an account, use [`DELETE /v1/me/payment-methods/{id}`](https://docs.getsinbad.com/api-reference/payment-accounts/delete-saved-payment-method).