Rate this page:

Capture Payments

Capture Payments widget


Capture Payments allows you to securely capture credit card details on a call and either tokenize or process the payment using a Payment Gateway. This widget uses the underlying TwiML verb <Pay>.

Note: Use of Capture Payments requires PCI Mode to be enabled in Voice Settings.

Optional Configuration:




Sets the limit in seconds to wait for the caller to press another digit before moving on to validate the digits captured.

Max Attempts

Number of times to retry when collecting information.


Language to speak when prompting the caller for credit card details.

Valid Card Types

Credit card types that should be accepted. Allows multiple values.

Request Security Code

Whether to prompt for credit card security code.

Request Postal Code

Whether to prompt for postal code.

Pay Connector

Unique Name corresponding to the Payment Gateway Connector installed in Twilio Add-ons

Payment Token Type

Select one-time payment or reusable payment.

Charge Card with Amount

Amount to be charged.


Currency to use when charging the card.


Description of the payment.





Payment has completed successfully.

Max Failed Attempts

Maximum number of failed attempts has been reached.

Provider Error

Error communicating with Payment Provider.

Pay Interrupted

Payment process interrupted by caller pressing *.

Hang Up

Caller hung up during payment process.

Validation Error

Invalid attributes received.

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.


        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!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more