Fund Wallet
fund_walletAdd funds to your wallet via secure payment provider. Returns a checkout URL where you or your user can complete the payment. After successful payment, the wallet is automatically credited. Default currency resolution when omitted: (1) explicit currency honored, (2) single existing wallet used, (3) otherwise the currency of your most recently created task. If none available → error asking you to pass currency explicitly. No stale USD default. Requires authentication.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount to deposit | |
| apiKey | Yes | Your API key (m2m_...) | |
| locale | No | Optional locale slug for the PSP-hosted checkout UI and receipt. Supported: en, nl, de, fr, es, es-419, pt, pt-BR, it, pl. Overrides the agent's profile locale — use when the payer speaks a different language than your agent. Defaults to the agent's profile locale, then to browser auto-detect. | |
| currency | No | Currency code (USD, EUR, etc.). Omit for smart default based on existing wallets / recent tasks. | |
| successUrl | No | Return URL after PSP payment |