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

# An independent yes

> The party that wants a change shouldn't be the one that says it was approved. BotShield takes the yes from your customer's own passkey, and signs a record neither you nor the agent wrote.

When an agent says "the user approved", that is the agent's word. When your own system logs an approval, that is your word. Either may be true. But after an agent is tricked, or when a customer disputes a change, neither one shows that the account holder said yes.

BotShield takes the yes from the account holder directly: on their own phone, in the BotShield app, with their passkey. Then it signs the record. It is the one record in the exchange that neither the party asking nor the agent acting could have written.

| Party | Does | In practice |
| - | - | - |
| **Your company** | **asks** | Your server, your support team or your agent sends a request that names one change and its exact terms. |
| **The account holder** | **answers** | They read the terms on their own device and approve with their passkey, or decline. |
| **BotShield** | **signs the record** | It records the answer and, for an approval, signs a result your server verifies. |

BotShield never asks your customer for an ID, a document or a selfie. Your customer is already your customer, and their passkey is what answers. BotShield doesn't decide anything either. It is not the checkout, the wallet or the card, and whether the change happens is your call.

## Why it has to be independent

BotShield is separate from your company and from the agent, so the signed record stands on its own.

* **Outside the agent's reach.** The answer is given on the account holder's own device, in a separate app, and requires user verification on the device that holds the passkey. An agent operating a browser or a signed-in session cannot give it.
* **Not the party asking.** The signed result comes from someone other than the company that wanted the change. It is a record you did not write yourself, which is what makes it worth keeping.
* **Bound to the account holder.** The request reaches the person whose account is BotShield Verified with you, on the device that holds their passkey.
* **Added to what you have.** Your sign-in, your fraud checks and any approvals your agent platform offers all stay. BotShield adds an independent yes on top, from the account holder.
* **The same everywhere.** Your customer sets up once. The same passkey answers at every company, and you do not build or run an approval system of your own.

The standards work points the same way. The Personal Agent Protocol's roadmap sets the goal that a company can verify the user approved the exact terms "instead of trusting the Personal Agent's word", and lists "a third party attests to the approval" among the routes. That is what BotShield does. See the [protocol's roadmap](https://personalagentprotocol.org/docs/path-to-1).

## What BotShield records

For an approval, BotShield signs a result that carries your request's ID, what was approved, and when. A Proof of Resolution, from Agents Ask, also carries a pairwise ID for your agent and the account holder, and a hash of the confirmation the passkey signed. A decline and an expired request are recorded and reported, and are not signed.

It carries no name, email address, document or phone number, because none was ever asked for. See [The privacy boundary](https://docs.botshield.ai/concepts/privacy-boundary.md) for the field-by-field list.

## What a signed approval shows

It shows that the holder of the account's passkey approved these exact terms, on their own device, at that time. Keep the signed result with your own record of the change.

## Where you meet it

| When | BotShield gives you | Read |
| - | - | - |
| Your agent or your team asks the account holder to approve a change | A signed Proof of Resolution | [Agents Ask](https://docs.botshield.ai/agents-ask/overview.md), [Proof of Resolution](https://docs.botshield.ai/agents-ask/proof-of-resolution.md) |
| A customer makes their account BotShield Verified | A signed statement that the account holder confirmed it | [Verified Accounts](https://docs.botshield.ai/verified-accounts/overview.md) |
| A customer's own agent places an order | A fresh answer at each order from the BotShield Signal API: verified: true or false. After the one-time approval, nobody is asked | [BotShield Signal API](https://docs.botshield.ai/poppy/agentic-checkout.md) |
| An account holder approves one named act | A signed token that carries your own string for the act | [BotShield Actions](https://docs.botshield.ai/actions/overview.md) |


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