> ## 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"
  }
}
```


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