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

# Get Payment Method Status

> Check if a cardholder has a payment method attached

<Warning>
  **Deprecated at the Rain + Coinbase launch** (removed \~30 days later). From
  launch, cards are funded by the user's USDC wallet instead of a saved payment
  method. See [Wallet Funding](/concepts/wallet-funding).
</Warning>

Returns whether the cardholder has a payment method attached and ready for card creation. A cardholder must have a payment method before you can create cards for them.

## Path parameters

<ParamField path="id" type="string" required>
  The cardholder's unique identifier.
</ParamField>

## Response

<ResponseField name="hasPaymentMethod" type="boolean">
  Whether the cardholder has a payment method attached.
</ResponseField>

<ResponseField name="paymentMethodId" type="string">
  The payment method ID. Only present when `hasPaymentMethod` is `true`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.agentcard.sh/api/v1/cardholders/ch_abc123/payment-method/status \
    -H "Authorization: Bearer sk_test_..."
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.agentcard.sh/api/v1/cardholders/ch_abc123/payment-method/status",
      headers={"Authorization": "Bearer sk_test_..."},
  )
  status = resp.json()
  if status["hasPaymentMethod"]:
      print("Ready to create cards")
  ```

  ```javascript Node.js theme={null}
  const resp = await fetch("https://api.agentcard.sh/api/v1/cardholders/ch_abc123/payment-method/status", {
    headers: {
      Authorization: "Bearer sk_test_...",
    },
  });
  const status = await resp.json();
  if (status.hasPaymentMethod) {
    console.log("Ready to create cards");
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 (payment method attached) theme={null}
  {
    "hasPaymentMethod": true,
    "paymentMethodId": "pm_abc123"
  }
  ```

  ```json 200 (no payment method) theme={null}
  {
    "hasPaymentMethod": false
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Cardholder not found"
  }
  ```
</ResponseExample>