Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now

Menu

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Capture Payments

Capture Payments widget

Description:

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:

Name

Description

Timeout

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

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

Currency to use when charging the card.

Description

Description of the payment.

Transitions:

Name

Description

Success

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 browsing the Twilio tag on Stack Overflow.