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

# add_funds

> Add money to the balance with Apple Pay, Google Pay, or card.

<Note>Renamed from `fund_wallet` in July 2026; the old name keeps working until August 20, 2026.</Note>

Adds money to the user's cash balance. It returns a secure checkout link the user opens to pay with Apple Pay, Google Pay, or card — calling the tool moves no money itself. Use it when the balance is too low for what the agent needs to do next.

## Parameters

| Parameter        | Type   | Required | Description                                                                                                                                        |
| ---------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `amount_cents`   | number | Yes      | Amount to add in cents, like `5000` for \$50.00. If the amount is out of range the tool tells you the allowed min and max — don't hardcode limits. |
| `payment_method` | string | No       | `apple_pay` or `google_pay`. Defaults to `apple_pay`.                                                                                              |

## Returns

An onramp session summary with a checkout URL the user must open to complete payment; check the updated balance with [get\_balance](/companies/mcp/tools/get_balance) once payment completes. If the user has no balance yet, the response asks you to call [get\_balance](/companies/mcp/tools/get_balance) first, since that provisions the account automatically. It also explains clearly when the amount is outside the allowed range.

Funding reuses the user's completed **identity verification** — there's no separate verification step inside checkout. If the user isn't verified yet, `add_funds` returns `kyc_required`: run [start\_kyc](/companies/mcp/tools/start_kyc), poll [get\_kyc\_status](/companies/mcp/tools/get_kyc_status) until verified, then retry. For an already-verified user no extra step is needed — the checkout link comes back directly. If the account is phone-only, funding may return `email_required` (add an email with `link_account` first, since a contact email is needed on the order).

## Example

```json theme={null}
{ "name": "add_funds", "arguments": { "amount_cents": 5000 } }
```