# Twilio / Telnyx: Introduction > Shuttle's Twilio integration lets you take payments over the phone using Twilio's capabilities. The caller keys their details on the phone keypad (DTMF), Shuttle's Twilio integration lets you take payments over the phone using Twilio's `` capabilities. The caller keys their details on the phone keypad (DTMF), and the Shuttle Pay connector passes them to Shuttle, so the card number never reaches your agents or your systems. Both card and ACH payments are supported. ## Integration methods Two questions decide how you integrate, and they are independent of each other. **Are your calls already on Twilio?** If so, go straight to the capture method below. If your calls are on Telnyx, use Telnyx's own `` verb instead: see the **[Telnyx IVR integration guide](/merchants/twilio/telnyx-guide/)**. If your voice traffic runs on another carrier, SIP trunk, PBX or contact centre platform, you do not need to move it: see **[Bring your own carrier](/merchants/twilio/byo-carrier/)**, which covers handing the caller over for the payment segment only. That choice carries PCI DSS scope consequences, so read it before you build. **Who keys the digits?** Twilio Pay supports two capture patterns: | Method | Use case | API | |--------|----------|-----| | **[IVR (self-service)](/merchants/twilio/integration-guide/)** | Automated payment collection: AI voice agents and IVR flows | `` TwiML verb | | **[Agent Assist](/merchants/twilio/agent-assist-guide/)** | Human agents in contact centres, or a custom capture workflow | Payments Subresource API | IVR capture works whichever carrier brought the call in: on Twilio, on Telnyx with its own `` verb, or on another carrier by handing the call to Twilio. Agent Assist uses Twilio's Payments Subresource API, so the call must be on Twilio while the card is taken: either because your calls already run there, or because you hand the call to Twilio for the payment segment, as [Bring your own carrier](/merchants/twilio/byo-carrier/) describes. For a fuller comparison of the two, see [How it works](/merchants/twilio/pay-architecture/#ivr-vs-agent-assist). ### IVR integration Use the `` TwiML verb (or Telnyx's `` TeXML verb) for fully automated payment collection. The customer keys their card into the call and `` handles the capture end to end, with no person involved. Best for: - AI voice agents: the agent hands the call to `` to take the card, and carries on once `` reports the result - Self-service bill pay - Automated payment reminders - After-hours payment collection ### Agent Assist integration Use the Payments Subresource API when an agent needs to guide customers through payment collection. The agent controls the flow through a custom UI while Twilio captures the card data. Best for: - Contact centre payments taken by human agents - AI agents that need a capture workflow `` doesn't offer - Complex transactions requiring agent assistance - Sales calls with payment collection ## Overview The Shuttle Pay connector provides: - **DTMF payment collection**: accept credit card and ACH payments through phone keypad input - **Reduced PCI DSS scope**: card numbers go from the carrier to Shuttle, never to your systems (see [Your PCI DSS obligations](/platforms/getting-started/pci-dss/)) - **Multiple payment methods**: credit cards and ACH bank debit - **Recurring payments**: set up scheduled and recurring payment plans - **Tokenisation**: save payment methods for future use - **Real-time processing**: immediate payment confirmation during calls ## Getting started ### Step 1: Install the Shuttle Pay connector To take payments through Twilio, install the Shuttle Pay connector in your Twilio account. #### Enable PCI Mode 1. Log in to your Twilio account 2. Go to Voice Settings 3. Select **Enable PCI Mode** 4. Accept the Terms and Conditions 5. Save your settings ![PCI Mode Setup](/_astro/cdn/dff639f40b/twilio_pci_mode.jpg) #### Install the Shuttle Pay connector 1. In Twilio Console, enter ` Connectors` in the **Jump to** search box, or [open Pay Connectors in Twilio Console](https://console.twilio.com/us1/develop/voice/manage/pay-connectors) 2. Select **Shuttle Pay Connector** from the catalogue ![Pay Connector Catalog](/_astro/cdn/abe90885f9/twilio_catalog.png) 3. Configure the connector with these settings: - **Unique Name**: `shuttle-pay-connector` (or similar: note it for later) - **Username**: your Shuttle instance key - **Password**: your Shuttle secret key If you can log in to the Merchant Portal, select **Configure** > **Voice Payments** > **Twilio** to see these values ready to copy. ![Connector Configuration](/_astro/cdn/5fb441fc3d/twilio_installed.png) :::tip Note the connector's **Unique Name**: you'll need it for the `paymentConnector` attribute of the `` verb in your TwiML. ::: ### Step 2: Test your configuration Shuttle's demo application lets you check your setup with a test call. #### Using the demo app The demo URL contains your secret key, so use the keys of a sandbox instance only, never live ones. 1. Map a Twilio phone number to the demo webhook URL: ``` https://twilio.shuttleglobal.com/demo/shuttle-pay-connector/{instance_key}/{secret_key}/start ``` Replace `shuttle-pay-connector` with your connector's unique name from step 1. **Configure** > **Voice Payments** > **Twilio** in the Merchant Portal shows the demo URL with your keys filled in. If you run the demo app yourself from its source code, use your own host instead. 2. Configure your phone number: - Go to **Phone Numbers** > **Manage** > **Active Numbers** in Twilio Console, or [open Active Numbers in Twilio Console](https://console.twilio.com/us1/develop/phone-numbers/manage/incoming) - Set **Voice** > **A Call Comes In** to **Webhook** - Enter the demo URL and set the method to **HTTP POST** - Save the configuration 3. Call your configured number and follow the prompts to make a test payment with a [Sandbox Gateway test card](/merchants/testing/sandbox-gateway/). ![Demo Configuration](/_astro/cdn/bd828e0eed/twilio_demo.png) > **Resources**: View the demo app [source code](https://github.com/shuttle-global/twilio-demo-app) or watch the [walkthrough video](https://www.loom.com/share/5c1f10aa3d5a4e6fa933b4e3675533d2). ## Next steps Once you've verified your setup with the demo app, choose your integration method: **[How it works](/merchants/twilio/pay-architecture/)** - Worth reading first: - How cardholder data moves between the four parties - PCI DSS scope, failure modes, and IVR vs Agent Assist compared **[Twilio IVR integration guide](/merchants/twilio/integration-guide/)** - For automated self-service payments: - Implement the `` verb in your TwiML - Handle payment responses and errors **[Twilio Agent Assist integration guide](/merchants/twilio/agent-assist-guide/)** - For contact centre payments: - Build a custom payment widget for agents - Use the Payments Subresource API **[Shuttle Pay connector reference](/merchants/twilio/shuttle-connector-reference/)** - Detailed reference for both methods: - Request parameters and response fields - Status values and decline types - Webhooks and API operations **[Telnyx IVR integration guide](/merchants/twilio/telnyx-guide/)** - If your calls are on Telnyx: - Self-service capture with Telnyx's `` TeXML verb, no Twilio account needed - Read the result back from Shuttle **[Bring your own carrier](/merchants/twilio/byo-carrier/)** - If your calls are on another platform: - Hand the caller over for the payment segment only, from any carrier, SIP trunk, PBX or contact centre platform - Choose between the bridge and handoff call flows, and their PCI DSS consequences