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

# confirm_collection

> Report your collection outcome for a company-wallet transfer awaiting it (the card_flow.started webhook is your cue): "succeeded" when you've secured payment f…

Connect to `https://mcp.agentcard.sh/mcp` with your **organization credential** (`client_id` + `client_secret`, or the org access token).

## What it does

Report your collection outcome for a company-wallet transfer awaiting it (the card\_flow\.started webhook is your cue): "succeeded" when you've secured payment from your own customer (the transfer proceeds and the card is created), "failed" to release the reservation. Idempotent per outcome.

## Inputs

| Field                      | Type                           | Description              |
| -------------------------- | ------------------------------ | ------------------------ |
| `transfer_id` *(required)* | string                         | The transfer id (owt\_…) |
| `outcome` *(required)*     | string: `succeeded` · `failed` | Your collection result   |

## Returns

| Field                  | Type   | Description                        |
| ---------------------- | ------ | ---------------------------------- |
| `message` *(required)* | string | Human-readable outcome.            |
| `transfer`             | object | The transfer after the transition. |

## Example call

```json theme={null}
{
  "tool": "confirm_collection",
  "arguments": {
    "transfer_id": "\u2026",
    "outcome": "\u2026"
  }
}
```