Skip to main content
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!

​
Adding a Request Payment Action

To add a Request Payment action to your agent:
  1. Log into your account and navigate to the agent editor.
  2. Click the (+) button in the Functions section and select the “Request Payment” action.
Request Payment function

​
Configuring the Request Payment Action

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.

​
Example Instructions

Here is an example of how you might configure a request payment action: 
- **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]"
        }

​
Use Cases

The Request Payment action can be used in various scenarios:
  • Paid Consultations: Require payment before the agent uses the Schedule function to book a meeting with you.
  • Premium Service Payments: Collect payments for premium memberships, VIP services, or exclusive content.
  • Outstanding Balances: Request payments for any outstanding balances or overdue invoices.
  • Event Registrations: Charge for event registrations, bookings, or reservations.

​
Webhooks

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.

​
Fees

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.

​
Terms

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.