Rate this page:

Pay Connectors

Pay Connectors are integrations with payment processors/gateways that allow you to tokenize payment details and create charges on credit and debit cards. In a matter of minutes, a merchant or ISV (independent software vendor) can start accepting payments over a phone call without having to become PCI Compliant.


A tokenized payment is a payment that doesn't have any charge associated to it. A tokenized payment returns a token which represents a payment method information in the payment provider system (e.g. customer ID). In order to tokenize a payment using <Pay>, the chargeAmount should be 0 or not present.

A charge transaction means you want to immediately capture funds from the customer's supplied payment method (i.e. credit card) in return for the goods or services you offer. In order to create a charge transaction with <Pay>, the chargeAmount should be greater than 0.

Pay Connectors are available as a part of Twilio Programmable Voice. You can choose your preferred payment processor/gateway and instantly install it for free. Once installed, you must authorize Twilio to initiate transactions on your behalf.

Pay Connectors Console page listing available Pay Connectors

Supported products

Twilio Pay Connectors are currently supported only by Programmable Voice. Navigate to Pay Connectors in Twilio console to see list of available connectors.

If you don't see your preferred payment processor/gateway in the list of branded connectors, you can use a Generic Pay Connector. Note: The payment processor/gateway will need to write custom, PCI-compliant code to work with Twilio's Generic Pay Connector.

Install and configure a Pay Connector

Install Pay Connectors

Twilio's available Pay Connectors can be found here in the Console. To get started, click on your preferred Pay Connector and install it. This creates an instance of the Pay Connector that you can configure with a Unique Name (Not treated as PII by Twilio).

Use "Default" as Unique Name for Pay Connector. Screenshot of Stripe Connector Page pointing to Unique Name of "Default"

Configuration and authorization

Each Pay Connector instance must be given a unique name as highlighted in the above diagram. The Unique Name must be unique to this Twilio account. If you enter Default, then when you invoke <Pay> you don't have to specify a paymentConnector attribute.

If you have multiple Pay Connector instances, you should use the paymentConnector attribute in your <Pay> verb to indicate which Pay Connector you want to use. See here to learn how to use <Pay>.

For example, to use a Pay Connector instance with a unique name of Stripe_Connector_1, use the following:

Loading Code Sample...
        Capture payment using a named connector instead of the default.

        Use a named Pay Connector

        Capture payment using a named connector instead of the default.

        To initiate transactions from Twilio to the payment processor/gateway, you must first have an account set up with the payment processor/gateway. Make sure to authorize Twilio to initiate transactions on your behalf.

        When you configure the Pay Connector instance you will do one of the following:

        1. Provide your credentials/secret keys for the payment processor/gateway.
        2. Authorize Twilio using a revocable access token.

        When possible, please provide authorization that is scoped to only tokenization or charges. Not all payment processors/gateways make this possible.

        Create multiple instances of a Pay Connector

        Twilio supports creating multiple instances of a Pay Connector. This means that you can create one instance of a Pay Connector for your production environment, another for your staging environment, and the third instance for your development environment.

        If using Stripe, you might create the following three instances:



        Pay Connector Instance

        Unique Name

        Stripe Mode













        Terms of Service

        Pay Connectors are provided and supported by Twilio. As a part of the Pay Connector installation process, you are required to accept Twilio’s Terms of Service.

        The Pay Connector is provided under Documentation specific to each payment gateway can be found on the Console under the documentation tab of the corresponding Pay Connector.

        Don’t see the payment processor/gateway you’re looking for?

        Help us prioritize our next Pay Connector to your preferred payment processor/gateway by requesting here.

        What's next?

        Learn how to capture your first payment using <Pay> with this Pay Connector tutorial.

        Rate this page:

        Need some help?

        We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

        Loading Code Sample...

              Thank you for your feedback!

              Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!