> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List payment methods

> List active merchant payment configurations for the current storefront environment.

Returns `ACTIVE` payment methods for the merchant and environment, including `REDEMPTION` when that method is on. `services.payments.list` hides those unless you pass `{ includeRedemptions: true }`. That flag is not a query parameter. Pass `order_id` to filter by the order's store, channel, brand, and fulfillment; conditions run against the order only when at least one payment has a condition. Without `order_id`, pass any of `fulfillment_id`, `store_id`, `channel_id`, and `brand_id` to filter by scope only (conditions are not evaluated). Kiosks use the scope form to cache payments once per session. Secrets (`private_key`, `webhook_signature`) are stripped. Use this to show checkout options — it is not the customer's saved cards.

> [!NOTE]
>
> Requires a Storefront API access token from [Token
> exchange](https://firespark.cloud/docs/storefront-api/oauth/exchange/post.md).

## Request

```bash theme={null}
curl "https://firespark.cloud/api/storefront/v1/payments?order_id=ord-abc123" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

Each item includes `provider`, `method`, public `config`, `status`, `conditions`, and `has_conditions`. Each condition carries an `interpretation` (`client`, `server`, or `both`): evaluate `client`/`both` conditions locally with `paymentMatchesClientConditions` from `@fire-spark/storefront`, or re-list with `order_id` to have the server check them all. Place order always re-checks every condition and rejects an unavailable payment with `422`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.