Skip to main content
Adds funds to the agent’s USD funding wallet via Apple Pay or Google Pay. Use it when the wallet balance is too low for what the agent needs to do next.

​
Parameters

ParameterTypeRequiredDescription
amount_centsnumberYesAmount to add in cents, like 5000 for 50.00.Allowedrangeis50.00. Allowed range is 2.00 to $10,000.00 (200 to 1000000 cents).
payment_methodstringNoapple_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_wallet once payment completes. If no wallet exists yet, the response asks you to call get_wallet first, since that provisions one automatically. It also explains clearly when the amount is outside the allowed range or when a guest checkout daily or lifetime cap has been reached. The first time an account funds its wallet, the response is phone_verification_required: call start_phone_verification to send the user a one-time code, verify_phone with the code they read back, then retry fund_wallet. The verification stays fresh for 60 days. If the account is phone-only, funding may also return email_required (add an email with link_account first, since the payment provider needs a contact email on the order).

​
Example

{ "name": "fund_wallet", "arguments": { "amount_cents": 5000 } }