How to enable your Vida agent to request payment before it performs an action.
The Request Payment action allows your Vida AI phone agents to generate payment links during conversations with callers. This feature is essential for situations where a payment is required before a specific action or service can be performed. Very useful in combination with the Schedule function!
Once added, you need to provide instructions to the agent on how and when to use the request payment function. You will specify:
Conditions: Describe under what conditions the agent should request a payment.
Parameters: Define the details needed for the payment request, including the amount, currency (default, usd, or btc), reason, and any additional metadata.
Here is an example of how you might configure a request payment action:
Copy
Ask AI
- **Condition**: When the caller requests to purchase a premium membership.- **Parameters**: - **Amount**: "49.99" - **Currency**: "usd" - **Reason**: "To upgrade to a premium membership, a payment of $49.99 is required." - **Meta**: {}- **Condition**: When the caller wants to book a VIP service.- **Parameters**: - **Amount**: "150.00" - **Currency**: "usd" - **Reason**: "A payment of $150.00 is required to book the VIP service." - **Meta**: { "service_id": "vip123", "item": "[Item Name]" }- **Condition**: When the caller needs to pay an outstanding balance.- **Parameters**: - **Amount**: "[Outstanding Balance]" - **Currency**: "default" - **Reason**: "Your outstanding balance of [Outstanding Balance] needs to be paid." - **Meta**: { "customer_id": "[Caller ID]", "item": "[Item Name]" }
Vida can perform an HTTP POST request when payments to your agent occur. This is available via our Zapier integration or by configuring your own webhook via our API.
Vida charges a 15% fee to the receiver of the payment. Be sure to include this in your price calculation. Vida may sometimes charge payers fees for using various payment types.It is important to understand that people talking to your agent are buying “Vida Credit”. Vida Credit can be used to pay any other Vida agent. Once received as payment, Vida Credit can be withdrawn via Paypal, Venmo, ACH, or Bitcoin Lightning. Vida Credit received via credit card payment has a withdrawal hold of at least 30 days to protect against fraud. All withdrawals are subject to Vida’s Terms of Service.
It is important to note that all usage of Vida’s AI agent payment functionality is subject to Vida’s Terms of Service. No illegal activity permitted. Vida reserves the right to deny withdrawal of Vida Credit. Vida Credit is like Robux (Roblox), Minecraft Coins (Minecraft), V-Bucks (Fortnite) or other digital goods. There is no expectation or suggestion that it is your property like the cash in your wallet.