> ## 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.

# setup_cardholder_payment_method

> Set up a funding payment method for a cardholder — needed when create_card answers payment_method_required.

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

## What it does

Set up a funding payment method for a cardholder — needed when create\_card answers payment\_method\_required. In sandbox this adds a simulated Visa instantly. Live returns a checkout\_url: send the user there to enter their card on the hosted page, then poll get\_cardholder\_payment\_method\_status.

## Inputs

| Field                        | Type   | Description       |
| ---------------------------- | ------ | ----------------- |
| `cardholder_id` *(required)* | string | The cardholder id |

## Returns

| Field                  | Type   | Description                                                                                       |
| ---------------------- | ------ | ------------------------------------------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable next step.                                                                         |
| `status`               | string | "attached" (sandbox, instant) or "requires\_action" (live — user must finish on the hosted page). |
| `checkoutUrl`          | string | Present on requires\_action — send the user here.                                                 |

## Example call

```json theme={null}
{
  "tool": "setup_cardholder_payment_method",
  "arguments": {
    "cardholder_id": "\u2026"
  }
}
```