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

> ## Agent Instructions
> Sapiom Pay is for platforms whose agent shops for many end users. Each end user is a buyer with their own Sapiom key and saved cards.
> Use the buyer's key for every call made on that buyer's behalf. Never use one buyer's key for another user, and never give the agent the platform key.
> Agents call the hosted MCP tools at https://api.sapiom.ai/v1/mcp. Backends call the REST API at https://api.sapiom.ai/v1. Both take the key in an x-api-key header.
> Never ask a buyer for a card number, expiry date or CVV in chat. Buyers enter card details only on Sapiom's hosted pages.
> Follow the nextAction in each transaction result. Action links are secrets for the intended buyer only.
> Use one idempotencyKey per transaction. After a timeout, retry with the same key. Never start a new transaction to escape an uncertain outcome.
> Report an order as placed only when order.outcome is confirmed. If it is unknown, stop and hand off to a person.

# Show your brand on Sapiom's hosted pages

> Set the name and logo your users see when they save a card or approve a transaction.

Your users save cards and approve transactions on pages Sapiom hosts. Set your platform's name and logo so those pages look like part of your product.

## Set branding in the dashboard

1. In the [Sapiom dashboard](https://app.sapiom.ai/settings?tab=branding), go to **Settings** and open **Branding**.
2. Enter a **Display name**. Pages show your organization's name if you leave it empty.
3. Upload a **Logo**: a PNG, JPEG or WebP image up to 256 KB.
4. Check the **Preview**, then save.

Sapiom resizes logos to fit within 512 × 512 pixels. SVG and animated images are not accepted.

![Hosted Add a card page with the Wayfare logo, an email field, card number, expiry and CVV fields, and a Save card button](https://mintcdn.com/sapiom-1f975ca2/vcqXb2-NpI6o1Vkd/images/card-setup-page-v2.png?fit=max\&auto=format\&n=vcqXb2-NpI6o1Vkd\&q=85\&s=37afdb20363f0dd76e09b3b969a53dfb)

Card setup page

![Hosted Confirm this purchase page with the Wayfare logo, showing the merchant, total, card ending 4242, the item and a security code field](https://mintcdn.com/sapiom-1f975ca2/vcqXb2-NpI6o1Vkd/images/purchase-approval-page-v3.png?fit=max\&auto=format\&n=vcqXb2-NpI6o1Vkd\&q=85\&s=a70018390b161da63fbf0b56748d0fd4)

Transaction approval page


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