Payments
Payment integrations let agents create payment links, orders and charges, check payment status and issue refunds, using your own account with the payment provider. Money moves between your customer and your provider account; VoisX does not handle the funds.
Supported providers:
| Provider | Credentials you need |
|---|---|
| Stripe | Secret API key |
| Razorpay | Key ID and key secret |
| PayTabs | Profile ID and server key |
Never let an agent collect card numbers by voice or chat. Send the customer a payment link or hosted checkout page from the provider instead. Enable refund actions only if you really want the agent to issue refunds, and set clear limits in its prompt.
Connect
- Get the credentials from your provider (see below). Use test-mode keys while you build your agent.
- In the VoisX console, open your project and go to Tools → Add tool → From template.
- Find the provider and select it.
- Enter the credentials, select the actions you want to enable and click Install integration.
Stripe
Find your secret key in the Stripe Dashboard under Developers → API keys. A restricted key with only the permissions you need is safer than your full secret key.
| Action | What it does |
|---|---|
| Get Payment Status | Checks the status of a payment |
| Create Payment Link | Creates a payment link to send to the customer |
| List Charges | Lists recent charges |
| Create Payment Intent | Creates a payment intent |
| Create Refund | Refunds a payment |
Razorpay
Find your Key ID and Key Secret in the Razorpay Dashboard under Account & Settings → API Keys.
| Action | What it does |
|---|---|
| Create Order | Creates a Razorpay order |
| Capture Payment | Captures an authorized payment |
| Create Refund | Refunds a payment |
PayTabs
Find your Profile ID and Server Key in the PayTabs merchant dashboard under Developers → Key management. When you install PayTabs, also enter the Region Endpoint for your PayTabs account, for example https://secure.paytabs.com (UAE and global) or https://secure.paytabs.sa (Saudi Arabia).
| Action | What it does |
|---|---|
| Create Charge | Creates a payment page for the customer |
| Create Refund | Refunds a transaction |
| Query Transaction | Checks the status of a transaction |
Example: take a payment by link
When the customer is ready to pay:
1. Confirm the amount and what it is for.
2. Use Create Payment Link for that amount.
3. Send the link by SMS or email, and tell the customer the link is secure and from our payment provider.
4. If they ask, use Get Payment Status to confirm the payment went through.
Never ask the customer to read out card details.
Troubleshooting
Authentication errors
Check that you used live keys for live payments and test keys for testing. The two cannot be mixed.
Refund fails
The payment may already be refunded, or the refund is larger than the amount captured.