Skip to main content
Stripe is a global payment processing platform used by businesses of all sizes. PolyAI’s Stripe integration enables voice agents to handle payment-related queries and actions.
Direct card payment collection over voice requires PCI DSS compliance measures. For secure payment capture, consider using PCI Pal in combination with Stripe as your payment gateway.

​
Capabilities

  • Payment status lookup: Check the status of existing payments or charges
  • Coupon creation: Generate promotional discounts for customers
  • Refund processing: Initiate refunds for eligible transactions
  • Subscription management: Query subscription status and details

​
Getting started

​
Prerequisites

  • A Stripe account (Test or Live mode)
  • Stripe API keys
  • PolyAI project access

​
Step 1: Obtain API credentials

  1. Log in to your Stripe Dashboard
  2. Navigate to Developers → API keys
  3. Copy your:
    • Publishable key: For client-side operations (if needed)
    • Secret key: For server-side API calls
  4. For webhooks (if required), create a webhook endpoint and note the Webhook secret
Never share your secret key publicly. Use test mode keys for development and testing.

​
Step 2: Configure webhook (optional)

If your integration requires real-time payment notifications:
  1. Go to Developers → Webhooks
  2. Click Add endpoint
  3. Enter the webhook URL provided by PolyAI
  4. Select the events you want to receive (e.g., payment_intent.succeeded, charge.refunded)

​
Step 3: Provide credentials to PolyAI

Securely share with your PolyAI team:
  • API secret key
  • Webhook secret (if using webhooks)
  • Any specific configuration requirements

​
Use cases

​
Payment confirmation

Caller: “Did my payment go through?” Agent: Looks up recent charges by customer email/phone and confirms payment status.

​
Refund requests

Caller: “I’d like a refund for my order.” Agent: Verifies the transaction and initiates the refund through Stripe.

​
Promotional discounts

Caller: “I was promised a discount.” Agent: Creates a one-time coupon in Stripe and provides the code to the caller.

​
Limitations

  • Card collection: Direct card number collection requires PCI compliance; use PCI Pal for secure capture
  • Dispute handling: Complex dispute resolution requires human intervention
  • Account changes: Sensitive account modifications should be verified through additional authentication

​
Security

  • API keys are stored as encrypted secrets
  • All API calls use HTTPS
  • Webhook signatures are verified to prevent spoofing

​
Support

For integration assistance, contact your PolyAI account manager. For Stripe-specific questions, consult the Stripe Documentation.