twilio-ruby 5.39.1 → 5.40.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fdc4e2781cfb9b6a282ef7231251f6da2d92b54759750cbb09ad7d740af7b9f
-  data.tar.gz: 8cc7809e41c1da0ee5764c9683b6f5cfc87a5b63eba2fd1e00071c0286520ea4
+  metadata.gz: 88d33c49dd845714de79ae304f9481c5a154d64d9f384030cc39254283d5e5b0
+  data.tar.gz: 9ebfad3f85d6d17df150230d19ac036bc77c2329a1dcf8d32f917dad7f493174
 SHA512:
-  metadata.gz: 9637c20fa554711bd82194b9af9cbf1f19ee22b65ef3259364896f4887c88c6b319a33ff22e500ca892a42b3cf3bf5b7e4c772bec591ff9eaac886f461f06e11
-  data.tar.gz: eecc1ee22886d77f2e91ce00c90198a94bad7fbf890a992bd27848b1a9082dfbb249a1f48dacea95f8da2dda1190b0be92aa919f5f20ee38562c7a3fc7c067bb
+  metadata.gz: bcc344b8dbf6b62fb02b5f91df404131f6056da9a0e99eadb68949cd8fd1506fb566dd1eb67a7c63b44415808dc9395ba73bc16638443a3122a0242749899f11
+  data.tar.gz: 3f92a7d9204b0a9833f4e1b3d00c2598cca620da1cc66d616fa45991715ccf6e57ec71fb0bf3308f840e5f69cdd966b41784870e8a97a6496f2af780fdd8e7bf

data/.travis.yml

@@ -36,7 +36,7 @@ deploy:
 
 notifications:
   slack:
-    if: branch = master
+    if: branch = main
     on_pull_requests: false
     on_success: never
     on_failure: change

data/CHANGES.md

@@ -1,6 +1,106 @@
 twilio-ruby changelog
 =====================
 
+[2020-09-16] Version 5.40.2
+---------------------------
+**Library - Fix**
+- [PR #530](https://github.com/twilio/twilio-ruby/pull/530): drop the page limit calculation. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Conversations**
+- Expose Configuration and Service Configuration resources
+- Add Unique Name support for Conversations
+- Add Services Push Notification resource
+- Add Service scoped Conversation resources
+- Support Identity in Users resource endpoint
+
+**Messaging**
+- GA Deactivation List API
+- Add domain cert API's(fetch, update, create) for link tracker
+
+**Numbers**
+- Add API endpoint for Supporting Document deletion
+
+**Proxy**
+- Updated usage of FailOnParticipantConflict param to apply only to accounts with ProxyAllowParticipantConflict account flag
+
+**Supersim**
+- Add `AccountSid` parameter to Sim resource update request
+- Add `ready` status as an available status for a Sim resource
+
+
+[2020-09-02] Version 5.40.1
+---------------------------
+**Library - Chore**
+- [PR #529](https://github.com/twilio/twilio-ruby/pull/529): sort files for deterministic require order. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+**Ai**
+- Initial release
+
+**Bulkexports**
+- removing public beta feature flag from BulkExports Jobs API
+
+**Messaging**
+- Add Deactivation List API
+- Added page token parameter for fetch in WhatsApp Templates API
+
+**Numbers**
+- Add API endpoint for End User deletion
+
+**Routes**
+- Add Resource Route Configurations API
+- Add Route Configurations API
+- Initial Release
+
+**Trunking**
+- Added `transfer_mode` property on Trunks.
+
+
+[2020-08-19] Version 5.40.0
+---------------------------
+**Library - Chore**
+- [PR #526](https://github.com/twilio/twilio-ruby/pull/526): update GitHub branch references to use HEAD. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+
+**Conversations**
+- Allow Identity addition to Participants
+
+**Events**
+- Sinks API Get all Sinks
+
+**Proxy**
+- Clarified usage of FailOnParticipantConflict param as experimental
+- Add FailOnParticipantConflict param to Proxy Session create and Proxy Participant create
+
+**Supersim**
+- Add fleet, network, and isoCountryCode to the UsageRecords resource
+- Change sort order of UsageRecords from ascending to descending with respect to start time field, records are now returned newest to oldest
+
+**Wireless**
+- Removed `Start` and `End` parameters from the Data Sessions list endpoint. **(breaking change)**
+
+
+[2020-08-05] Version 5.39.3
+---------------------------
+**Messaging**
+- Add rejection reason support to WhatsApp API
+- Removed status parameter for create and update in WhatsApp Templates API
+
+**Proxy**
+- Add FailOnParticipantConflict param to Proxy Session update
+
+**Verify**
+- Add `CustomFriendlyName` optional parameter on Verification creation.
+- Changes in `Challenge` resource to update documentation of both `details` and `hidden_details` properties.
+
+
+[2020-07-22] Version 5.39.2
+---------------------------
+**Api**
+- Add optional Click Tracking and Scheduling parameters to Create action of Message resource
+
+**Supersim**
+- Add callback_url and callback_method parameters to Sim resource update request
+
+
 [2020-07-10] Version 5.39.1
 ---------------------------
 **Library - Fix**
@@ -481,7 +581,7 @@ twilio-ruby changelog
 **Library**
 - [PR #481](https://github.com/twilio/twilio-ruby/pull/481): added request validation for urls with and without ports. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
 - [PR #480](https://github.com/twilio/twilio-ruby/pull/480): Update resources after sorting. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
-- [PR #479](https://github.com/twilio/twilio-ruby/pull/479): Auto-deploy via Travis CI upon tagged commit to master. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #479](https://github.com/twilio/twilio-ruby/pull/479): Auto-deploy via Travis CI upon tagged commit to main. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
 
 **Api**
 - Add new usage categories to the public api `sms-messages-carrierfees` and `mms-messages-carrierfees`

data/CONTRIBUTING.md

@@ -105,7 +105,7 @@ Before you submit your pull request consider the following guidelines:
 * Make your changes in a new git branch:
 
     ```shell
-    git checkout -b my-fix-branch master
+    git checkout -b my-fix-branch main
     ```
 
 * Create your patch, **including appropriate test cases**.
@@ -132,7 +132,7 @@ Before you submit your pull request consider the following guidelines:
     git push origin my-fix-branch
     ```
 
-In GitHub, send a pull request to `twilio-ruby:master`.
+In GitHub, send a pull request to `twilio-ruby:main`.
 If we suggest changes, then:
 
 * Make the required updates.

data/ISSUE_TEMPLATE.md

@@ -1,5 +1,9 @@
 <!--
 If this is a feature request, make sure you search Issues for an existing request before creating a new one!
+
+Please utilize the template below to help us resolve your issue.
+
+Note that many issues can be resolved by updating to the latest version.
 -->
 
 ### Issue Summary
@@ -21,6 +25,6 @@ A summary of the issue and the environment in which it occurs. If suitable, incl
 ```
 
 ### Technical details:
-* twilio-ruby version:
+* twilio-ruby version: 
 * ruby version:
 

data/Makefile

@@ -4,7 +4,7 @@ githooks:
 	ln -sf ../../githooks/pre-commit .git/hooks/pre-commit
 
 install: githooks
-	bundle install; bundle exec rake install
+	bundle install --with development; bundle exec rake install
 
 test: lint
 	bundle exec rake spec

data/PULL_REQUEST_TEMPLATE.md

@@ -23,7 +23,7 @@ A short description of what this PR does.
 - [ ] I have made a material change to the repo (functionality, testing, spelling, grammar)
 - [ ] I have read the [Contribution Guidelines](CONTRIBUTING.md) and my PR follows them
 - [ ] I have titled the PR appropriately
-- [ ] I have updated my branch with the master branch
+- [ ] I have updated my branch with the main branch
 - [ ] I have added tests that prove my fix is effective or that my feature works
 - [ ] I have added necessary documentation about the functionality in the appropriate .md file
 - [ ] I have added inline documentation to the code I modified

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://img.shields.io/gem/v/twilio-ruby.svg)](https://rubygems.org/gems/twilio-ruby)
 [![Learn with TwilioQuest](https://img.shields.io/static/v1?label=TwilioQuest&message=Learn%20to%20contribute%21&color=F22F46&labelColor=1f243c&style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAMAAAD04JH5AAAASFBMVEUAAAAZGRkcHBwjIyMoKCgAAABgYGBoaGiAgICMjIyzs7PJycnMzMzNzc3UoBfd3d3m5ubqrhfrMEDu7u739/f4vSb/3AD///9tbdyEAAAABXRSTlMAAAAAAMJrBrEAAAKoSURBVHgB7ZrRcuI6EESdyxXGYoNFvMD//+l2bSszRgyUYpFAsXOeiJGmj4NkuWx1Qeh+Ekl9DgEXOBwOx+Px5xyQhDykfgq4wG63MxxaR4ddIkg6Ul3g84vCIcjPBA5gmUMeXESrlukuoK33+33uID8TWeLAdOWsKpJYzwVMB7bOzYSGOciyUlXSn0/ABXTosJ1M1SbypZ4O4MbZuIDMU02PMbauhhHMHXbmebmALIiEbbbbbUrpF1gwE9kFfRNAJaP+FQEXCCTGyJ4ngDrjOFo3jEL5JdqjF/pueR4cCeCGgAtwmuRS6gDwaRiGvu+DMFwSBLTE3+jF8JyuV1okPZ+AC4hDFhCHyHQjdjPHUKFDlHSJkHQXMB3KpSwXNGJPcwwTdZiXlRN0gSp0zpWxNtM0beYE0nRH6QIbO7rawwXaBYz0j78gxjokDuv12gVeUuBD0MDi0OQCLvDaAho4juP1Q/jkAncXqIcCfd+7gAu4QLMACCLxpRsSuQh0igu0C9Svhi7weAGZg50L3IE3cai4IfkNZAC8dfdhsUD3CgKBVC9JE5ABAFzg4QL/taYPAAWrHdYcgfLaIgAXWJ7OV38n1LEF8tt2TH29E+QAoDoO5Ve/LtCQDmKM9kPbvCEBApK+IXzbcSJ0cIGF6e8gpcRhUDogWZ8JnaWjPXc/fNnBBUKRngiHgTUSivSzDRDgHZQOLvBQgf8rRt+VdBUUhwkU6VpJ+xcOwQUqZr+mR0kvBUgv6cB4+37hQAkXqE8PwGisGhJtN4xAHMzrsgvI7rccXqSvKh6jltGlrOHA3Xk1At3LC4QiPdX9/0ndHpGVvTjR4bZA1ypAKgVcwE5vx74ulwIugDt8e/X7JgfkucBMIAr26ndnB4UCLnDOqvteQsHlgX9N4A+c4cW3DXSPbwAAAABJRU5ErkJggg==)](https://twil.io/learn-open-source)
 
+**The default branch name for this repository has been changed to `main` as of 07/27/2020.**
+
 ## Documentation
 
 The documentation for the Twilio API can be found [here][apidocs].
@@ -32,13 +34,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.39.1'
+gem 'twilio-ruby', '~> 5.40.2'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.39.1
+gem install twilio-ruby -v 5.40.2
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -212,7 +214,6 @@ If you've instead found a bug in the library or would like new features added, g
 [libdocs]: https://www.twilio.com/docs/libraries/ruby
 [refdocs]: https://twilio.github.io/twilio-ruby
 [capability]: https://github.com/twilio/twilio-ruby/wiki/JWT-Tokens
-[examples]: https://github.com/twilio/twilio-ruby/blob/master/examples
 [wiki]: https://github.com/twilio/twilio-ruby/wiki
 [bundler]: https://bundler.io
 [rubygems]: https://rubygems.org

data/lib/twilio-ruby/framework/version.rb

@@ -112,18 +112,13 @@ module Twilio
       end
 
       def read_limits(limit = nil, page_size = nil)
-        page_limit = nil
-
-        unless limit.nil?
-          # If there is no user-specified page_size, pick the most network efficient size
+        unless limit.nil? || page_size
           page_size = limit
-          page_limit = (limit / page_size.to_f).ceil
         end
 
         {
           limit: limit || nil,
-          page_size: page_size || nil,
-          page_limit: page_limit
+          page_size: page_size || nil
         }
       end
 

data/lib/twilio-ruby/rest/api/v2010/account/application.rb

@@ -278,8 +278,9 @@ module Twilio
             #   occurs while retrieving or executing the TwiML from `sms_url`.
             # @param [String] sms_fallback_method The HTTP method we should use to call
             #   `sms_fallback_url`. Can be: `GET` or `POST`.
-            # @param [String] sms_status_callback The URL we should call using a POST method
-            #   to send status information about SMS messages sent by the application.
+            # @param [String] sms_status_callback Same as message_status_callback: The URL we
+            #   should call using a POST method to send status information about SMS messages
+            #   sent by the application. Deprecated, included for backwards compatibility.
             # @param [String] message_status_callback The URL we should call using a POST
             #   method to send message status information to your application.
             # @return [ApplicationInstance] Updated ApplicationInstance
@@ -545,8 +546,9 @@ module Twilio
             #   occurs while retrieving or executing the TwiML from `sms_url`.
             # @param [String] sms_fallback_method The HTTP method we should use to call
             #   `sms_fallback_url`. Can be: `GET` or `POST`.
-            # @param [String] sms_status_callback The URL we should call using a POST method
-            #   to send status information about SMS messages sent by the application.
+            # @param [String] sms_status_callback Same as message_status_callback: The URL we
+            #   should call using a POST method to send status information about SMS messages
+            #   sent by the application. Deprecated, included for backwards compatibility.
             # @param [String] message_status_callback The URL we should call using a POST
             #   method to send message status information to your application.
             # @return [ApplicationInstance] Updated ApplicationInstance

data/lib/twilio-ruby/rest/api/v2010/account/available_phone_number/local.rb

@@ -38,7 +38,7 @@ module Twilio
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
               #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern). If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -125,7 +125,7 @@ module Twilio
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
               #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern). If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -228,7 +228,7 @@ module Twilio
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
               #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern). If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.

data/lib/twilio-ruby/rest/api/v2010/account/call/payment.rb

@@ -36,50 +36,59 @@ module Twilio
 
               ##
               # Create the PaymentInstance
-              # @param [String] idempotency_key A unique token for each payment session that
-              #   should be provided to maintain idempotency of the session.
-              # @param [String] status_callback The URL we should call using the
-              #   `status_callback` to send status information of payment session.
-              # @param [payment.BankAccountType] bank_account_type If Payment source is ACH,
-              #   type of bank account. Can be: `consumer-checking`, `consumer-savings`,
+              # @param [String] idempotency_key A unique token that will be used to ensure that
+              #   multiple API calls with the same information do not result in multiple
+              #   transactions. This should be a unique string value per API call and can be a
+              #   randomly generated.
+              # @param [String] status_callback Provide an absolute or relative URL to receive
+              #   status updates regarding your Pay session. Read more about the [expected
+              #   StatusCallback
+              #   values](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback)
+              # @param [payment.BankAccountType] bank_account_type Type of bank account if
+              #   payment source is ACH. One of `consumer-checking`, `consumer-savings`, or
               #   `commercial-checking`. The default value is `consumer-checking`.
-              # @param [String] charge_amount If this field is present and greater than `0.0`
-              #   payment source will be charged. Otherwise payment source will be tokenized.
-              # @param [String] currency Currency `charge_amount` is in. It's format should be
-              #   as specified in [ISO
+              # @param [String] charge_amount A positive decimal value less than 1,000,000 to
+              #   charge against the credit card or bank account. Default currency can be
+              #   overwritten with `currency` field. Leave blank or set to 0 to tokenize.
+              # @param [String] currency The currency of the `charge_amount`, formatted as [ISO
               #   4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format. The
-              #   default value is `USD`.
-              # @param [String] description Decription of the charge.
-              # @param [String] input Kind of medium customer would enter payment source
-              #   information in. Currently only 'DTMF' is supported, which means customer would
-              #   use keypad of their phone to enter card number etc.
-              # @param [String] min_postal_code_length If postal code is expected, minimum
-              #   length of the postal code. When user enters postal code, this value will be used
-              #   to validate.
-              # @param [Hash] parameter Additonal data to be sent over to payment provider. It
-              #   has to be a JSON string with only one level object. This parameter can be used
-              #   to send information such as customer name, phone number etc. Refer to specific
-              #   payment provider's documentation in Twilio console for supported
-              #   names/values/format.
-              # @param [String] payment_connector Payment connector that you would like Twilio
-              #   to use for processing payments. The default value is `Default`, which means you
-              #   need to have at least one payment connector configured in Twilio with name
-              #   'Default'. If not you must provide connector configuration name here.
-              # @param [payment.PaymentMethod] payment_method Payment source type. Can be:
-              #   `credit-card`, `ach-debit`. The default value is `credit-card`.
-              # @param [Boolean] postal_code Whether to expect postal code during payment source
-              #   data gathering. Can be: `true`, `false`. The default value is `true`.
-              # @param [Boolean] security_code Whether to expect security code during payment
-              #   source data gathering. Can be: `true`, `false`. The default value is `true`.
-              # @param [String] timeout The number of seconds that we should allow customer to
-              #   enter payment information. Can be an integer between `5` and `600`, inclusive.
-              #   The default value is `5`.
-              # @param [payment.TokenType] token_type If tokenization of payment source is
-              #   desired, this represents type of token. Can be: `one-time`, `reusable`. The
-              #   default value is `reusable`.
-              # @param [String] valid_card_types List of card types accepted with each card
-              #   types separated by space. Can be:
-              #   `visa`,`nmastercard`,`amex`,`maestro`,`discover`,`optima`,`jcb`,`diners-club`,`enroute`. The default value is `visa mastercard amex`.
+              #   default value is `USD` and all values allowed from the <Pay> Connector are
+              #   accepted.
+              # @param [String] description The description can be used to provide more details
+              #   regarding the transaction. This information is submitted along with the payment
+              #   details to the Payment Connector which are then posted on the transactions.
+              # @param [String] input A list of inputs that should be accepted. Currently only
+              #   `dtmf` is supported. All digits captured during a pay session are redacted from
+              #   the logs.
+              # @param [String] min_postal_code_length A positive integer that is used to
+              #   validate the length of the `PostalCode` inputted by the user. User must enter
+              #   this many digits.
+              # @param [Hash] parameter A single level JSON string that is required when
+              #   accepting certain information specific only to ACH payments. The information
+              #   that has to be included here depends on the <Pay> Connector. [Read
+              #   more](https://www.twilio.com/console/voice/pay-connectors).
+              # @param [String] payment_connector This is the unique name corresponding to the
+              #   Payment Gateway Connector installed in the Twilio Add-ons. Learn more about
+              #   [<Pay> Connectors](https://www.twilio.com/console/voice/pay-connectors). The
+              #   default value is `Default`.
+              # @param [payment.PaymentMethod] payment_method Type of payment being captured.
+              #   One of `credit-card` or `ach-debit`. The default value is `credit-card`.
+              # @param [Boolean] postal_code Indicates whether the credit card postal code (zip
+              #   code) is a required piece of payment information that must be provided by the
+              #   caller. The default is `true`.
+              # @param [Boolean] security_code Indicates whether the credit card security code
+              #   is a required piece of payment information that must be provided by the caller.
+              #   The default is `true`.
+              # @param [String] timeout The number of seconds that <Pay> should wait for the
+              #   caller to press a digit between each subsequent digit, after the first one,
+              #   before moving on to validate the digits captured. The default is `5`, maximum is
+              #   `600`.
+              # @param [payment.TokenType] token_type Indicates whether the payment method
+              #   should be tokenized as a `one-time` or `reusable` token. The default value is
+              #   `reusable`. Do not enter a charge amount when tokenizing. If a charge amount is
+              #   entered, the payment method will be charged and not tokenized.
+              # @param [String] valid_card_types Credit card types separated by space that Pay
+              #   should accept. The default value is `visa mastercard amex`
               # @return [PaymentInstance] Created PaymentInstance
               def create(idempotency_key: nil, status_callback: nil, bank_account_type: :unset, charge_amount: :unset, currency: :unset, description: :unset, input: :unset, min_postal_code_length: :unset, parameter: :unset, payment_connector: :unset, payment_method: :unset, postal_code: :unset, security_code: :unset, timeout: :unset, token_type: :unset, valid_card_types: :unset)
                 data = Twilio::Values.of({
@@ -177,15 +186,20 @@ module Twilio
 
               ##
               # Update the PaymentInstance
-              # @param [String] idempotency_key A unique token for each payment session that
-              #   should be provided to maintain idempotency of the session.
-              # @param [String] status_callback The URL we should call using the
-              #   `status_callback` to send status information of payment session.
-              # @param [payment.Capture] capture Specific payment source information to expect.
-              #   Can be:
-              #   `payment-card-number`,`expiration-date`,`security-code`,`postal-code`,`bank-routing-number`,`bank-account-number`.
-              # @param [payment.Status] status Instruction to complete or cancel the
-              #   transaction. Can be: `complete`, `cancel.`
+              # @param [String] idempotency_key A unique token that will be used to ensure that
+              #   multiple API calls with the same information do not result in multiple
+              #   transactions. This should be a unique string value per API call and can be a
+              #   randomly generated.
+              # @param [String] status_callback Provide an absolute or relative URL to receive
+              #   status updates regarding your Pay session. Read more about the
+              #   [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
+              # @param [payment.Capture] capture The piece of payment information that you wish
+              #   the caller to enter. Must be one of `payment-card-number`, `expiration-date`,
+              #   `security-code`, `postal-code`, `bank-routing-number`, or `bank-account-number`.
+              # @param [payment.Status] status Indicates whether the current payment session
+              #   should be cancelled or completed. When `cancel` the payment session is
+              #   cancelled. When `complete`, Twilio sends the payment information to the selected
+              #   <Pay> connector for processing.
               # @return [PaymentInstance] Updated PaymentInstance
               def update(idempotency_key: nil, status_callback: nil, capture: :unset, status: :unset)
                 data = Twilio::Values.of({
@@ -309,15 +323,20 @@ module Twilio
 
               ##
               # Update the PaymentInstance
-              # @param [String] idempotency_key A unique token for each payment session that
-              #   should be provided to maintain idempotency of the session.
-              # @param [String] status_callback The URL we should call using the
-              #   `status_callback` to send status information of payment session.
-              # @param [payment.Capture] capture Specific payment source information to expect.
-              #   Can be:
-              #   `payment-card-number`,`expiration-date`,`security-code`,`postal-code`,`bank-routing-number`,`bank-account-number`.
-              # @param [payment.Status] status Instruction to complete or cancel the
-              #   transaction. Can be: `complete`, `cancel.`
+              # @param [String] idempotency_key A unique token that will be used to ensure that
+              #   multiple API calls with the same information do not result in multiple
+              #   transactions. This should be a unique string value per API call and can be a
+              #   randomly generated.
+              # @param [String] status_callback Provide an absolute or relative URL to receive
+              #   status updates regarding your Pay session. Read more about the
+              #   [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
+              # @param [payment.Capture] capture The piece of payment information that you wish
+              #   the caller to enter. Must be one of `payment-card-number`, `expiration-date`,
+              #   `security-code`, `postal-code`, `bank-routing-number`, or `bank-account-number`.
+              # @param [payment.Status] status Indicates whether the current payment session
+              #   should be cancelled or completed. When `cancel` the payment session is
+              #   cancelled. When `complete`, Twilio sends the payment information to the selected
+              #   <Pay> connector for processing.
               # @return [PaymentInstance] Updated PaymentInstance
               def update(idempotency_key: nil, status_callback: nil, capture: :unset, status: :unset)
                 context.update(