paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/controllers/payments_controller.rb

@@ -9,22 +9,27 @@ module PaypalServerSdk
     # Shows details for an authorized payment, by ID.
     # @param [String] authorization_id Required parameter: The ID of the
     # authorized payment for which to show details.
+    # @param [String] paypal_mock_response Optional parameter: PayPal's REST API
+    # uses a request header to invoke negative testing in the sandbox. This
+    # header configures the sandbox into a negative testing state for
+    # transactions that include the merchant.
     # @param [String] paypal_auth_assertion Optional parameter: An
     # API-caller-provided JSON Web Token (JWT) assertion that identifies the
     # merchant. For details, see
     # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
-    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
-    # which a partner is managing the API calls on behalf of a merchant, the
-    # partner must identify the merchant using either a PayPal-Auth-Assertion
-    # header or an access token with target_subject.</blockquote>
+    # rtion). Note:For three party transactions in which a partner is managing
+    # the API calls on behalf of a merchant, the partner must identify the
+    # merchant using either a PayPal-Auth-Assertion header or an access token
+    # with target_subject.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def authorizations_get(options = {})
+    def get_authorized_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v2/payments/authorizations/{authorization_id}',
                                      Server::DEFAULT)
                    .template_param(new_parameter(options['authorization_id'], key: 'authorization_id')
                                     .should_encode(true))
+                   .header_param(new_parameter(options['paypal_mock_response'], key: 'PayPal-Mock-Response'))
                    .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(Single.new('Oauth2')))
@@ -51,27 +56,29 @@ module PaypalServerSdk
     # Captures an authorized payment, by ID.
     # @param [String] authorization_id Required parameter: The PayPal-generated
     # ID for the authorized payment to capture.
+    # @param [String] paypal_mock_response Optional parameter: PayPal's REST API
+    # uses a request header to invoke negative testing in the sandbox. This
+    # header configures the sandbox into a negative testing state for
+    # transactions that include the merchant.
     # @param [String] paypal_request_id Optional parameter: The server stores
     # keys for 45 days.
     # @param [String] prefer Optional parameter: The preferred server response
-    # upon successful completion of the request. Value
-    # is:<ul><li><code>return=minimal</code>. The server returns a minimal
-    # response to optimize communication between the API caller and the server.
-    # A minimal response includes the <code>id</code>, <code>status</code> and
-    # HATEOAS links.</li><li><code>return=representation</code>. The server
-    # returns a complete resource representation, including the current state of
-    # the resource.</li></ul>
+    # upon successful completion of the request. Value is: return=minimal. The
+    # server returns a minimal response to optimize communication between the
+    # API caller and the server. A minimal response includes the id, status and
+    # HATEOAS links. return=representation. The server returns a complete
+    # resource representation, including the current state of the resource.
     # @param [String] paypal_auth_assertion Optional parameter: An
     # API-caller-provided JSON Web Token (JWT) assertion that identifies the
     # merchant. For details, see
     # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
-    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
-    # which a partner is managing the API calls on behalf of a merchant, the
-    # partner must identify the merchant using either a PayPal-Auth-Assertion
-    # header or an access token with target_subject.</blockquote>
+    # rtion). Note:For three party transactions in which a partner is managing
+    # the API calls on behalf of a merchant, the partner must identify the
+    # merchant using either a PayPal-Auth-Assertion header or an access token
+    # with target_subject.
     # @param [CaptureRequest] body Optional parameter: Example:
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def authorizations_capture(options = {})
+    def capture_authorized_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/v2/payments/authorizations/{authorization_id}/capture',
@@ -79,6 +86,7 @@ module PaypalServerSdk
                    .template_param(new_parameter(options['authorization_id'], key: 'authorization_id')
                                     .should_encode(true))
                    .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .header_param(new_parameter(options['paypal_mock_response'], key: 'PayPal-Mock-Response'))
                    .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter(options['prefer'], key: 'Prefer'))
                    .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
@@ -125,40 +133,37 @@ module PaypalServerSdk
     # Reauthorizes an authorized PayPal account payment, by ID. To ensure that
     # funds are still available, reauthorize a payment after its initial
     # three-day honor period expires. Within the 29-day authorization period,
-    # you can issue multiple re-authorizations after the honor period
-    # expires.<br/><br/>If 30 days have transpired since the date of the
-    # original authorization, you must create an authorized payment instead of
-    # reauthorizing the original authorized payment.<br/><br/>A reauthorized
-    # payment itself has a new honor period of three days.<br/><br/>You can
-    # reauthorize an authorized payment from 4 to 29 days after the 3-day honor
-    # period. The allowed amount depends on context and geography, for example
-    # in US it is up to 115% of the original authorized amount, not to exceed an
-    # increase of $75 USD.<br/><br/>Supports only the `amount` request
-    # parameter.<blockquote><strong>Note:</strong> This request is currently not
-    # supported for Partner use cases.</blockquote>
+    # you can issue multiple re-authorizations after the honor period expires.
+    # If 30 days have transpired since the date of the original authorization,
+    # you must create an authorized payment instead of reauthorizing the
+    # original authorized payment. A reauthorized payment itself has a new honor
+    # period of three days. You can reauthorize an authorized payment from 4 to
+    # 29 days after the 3-day honor period. The allowed amount depends on
+    # context and geography, for example in US it is up to 115% of the original
+    # authorized amount, not to exceed an increase of $75 USD. Supports only the
+    # `amount` request parameter. Note: This request is currently not supported
+    # for Partner use cases.
     # @param [String] authorization_id Required parameter: The PayPal-generated
     # ID for the authorized payment to reauthorize.
     # @param [String] paypal_request_id Optional parameter: The server stores
     # keys for 45 days.
     # @param [String] prefer Optional parameter: The preferred server response
-    # upon successful completion of the request. Value
-    # is:<ul><li><code>return=minimal</code>. The server returns a minimal
-    # response to optimize communication between the API caller and the server.
-    # A minimal response includes the <code>id</code>, <code>status</code> and
-    # HATEOAS links.</li><li><code>return=representation</code>. The server
-    # returns a complete resource representation, including the current state of
-    # the resource.</li></ul>
+    # upon successful completion of the request. Value is: return=minimal. The
+    # server returns a minimal response to optimize communication between the
+    # API caller and the server. A minimal response includes the id, status and
+    # HATEOAS links. return=representation. The server returns a complete
+    # resource representation, including the current state of the resource.
     # @param [String] paypal_auth_assertion Optional parameter: An
     # API-caller-provided JSON Web Token (JWT) assertion that identifies the
     # merchant. For details, see
     # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
-    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
-    # which a partner is managing the API calls on behalf of a merchant, the
-    # partner must identify the merchant using either a PayPal-Auth-Assertion
-    # header or an access token with target_subject.</blockquote>
+    # rtion). Note:For three party transactions in which a partner is managing
+    # the API calls on behalf of a merchant, the partner must identify the
+    # merchant using either a PayPal-Auth-Assertion header or an access token
+    # with target_subject.
     # @param [ReauthorizeRequest] body Optional parameter: Example:
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def authorizations_reauthorize(options = {})
+    def reauthorize_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/v2/payments/authorizations/{authorization_id}/reauthorize',
@@ -205,32 +210,35 @@ module PaypalServerSdk
     # authorized payment that has been fully captured.
     # @param [String] authorization_id Required parameter: The PayPal-generated
     # ID for the authorized payment to void.
+    # @param [String] paypal_mock_response Optional parameter: PayPal's REST API
+    # uses a request header to invoke negative testing in the sandbox. This
+    # header configures the sandbox into a negative testing state for
+    # transactions that include the merchant.
     # @param [String] paypal_auth_assertion Optional parameter: An
     # API-caller-provided JSON Web Token (JWT) assertion that identifies the
     # merchant. For details, see
     # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
-    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
-    # which a partner is managing the API calls on behalf of a merchant, the
-    # partner must identify the merchant using either a PayPal-Auth-Assertion
-    # header or an access token with target_subject.</blockquote>
+    # rtion). Note:For three party transactions in which a partner is managing
+    # the API calls on behalf of a merchant, the partner must identify the
+    # merchant using either a PayPal-Auth-Assertion header or an access token
+    # with target_subject.
     # @param [String] paypal_request_id Optional parameter: The server stores
     # keys for 45 days.
     # @param [String] prefer Optional parameter: The preferred server response
-    # upon successful completion of the request. Value
-    # is:<ul><li><code>return=minimal</code>. The server returns a minimal
-    # response to optimize communication between the API caller and the server.
-    # A minimal response includes the <code>id</code>, <code>status</code> and
-    # HATEOAS links.</li><li><code>return=representation</code>. The server
-    # returns a complete resource representation, including the current state of
-    # the resource.</li></ul>
+    # upon successful completion of the request. Value is: return=minimal. The
+    # server returns a minimal response to optimize communication between the
+    # API caller and the server. A minimal response includes the id, status and
+    # HATEOAS links. return=representation. The server returns a complete
+    # resource representation, including the current state of the resource.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def authorizations_void(options = {})
+    def void_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/v2/payments/authorizations/{authorization_id}/void',
                                      Server::DEFAULT)
                    .template_param(new_parameter(options['authorization_id'], key: 'authorization_id')
                                     .should_encode(true))
+                   .header_param(new_parameter(options['paypal_mock_response'], key: 'PayPal-Mock-Response'))
                    .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
                    .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter(options['prefer'], key: 'Prefer'))
@@ -272,14 +280,19 @@ module PaypalServerSdk
     # Shows details for a captured payment, by ID.
     # @param [String] capture_id Required parameter: The PayPal-generated ID for
     # the captured payment for which to show details.
+    # @param [String] paypal_mock_response Optional parameter: PayPal's REST API
+    # uses a request header to invoke negative testing in the sandbox. This
+    # header configures the sandbox into a negative testing state for
+    # transactions that include the merchant.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def captures_get(capture_id)
+    def get_captured_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v2/payments/captures/{capture_id}',
                                      Server::DEFAULT)
-                   .template_param(new_parameter(capture_id, key: 'capture_id')
+                   .template_param(new_parameter(options['capture_id'], key: 'capture_id')
                                     .should_encode(true))
+                   .header_param(new_parameter(options['paypal_mock_response'], key: 'PayPal-Mock-Response'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
@@ -307,31 +320,33 @@ module PaypalServerSdk
     end
 
     # Refunds a captured payment, by ID. For a full refund, include an empty
-    # payload in the JSON request body. For a partial refund, include an
-    # <code>amount</code> object in the JSON request body.
+    # payload in the JSON request body. For a partial refund, include an amount
+    # object in the JSON request body.
     # @param [String] capture_id Required parameter: The PayPal-generated ID for
     # the captured payment to refund.
+    # @param [String] paypal_mock_response Optional parameter: PayPal's REST API
+    # uses a request header to invoke negative testing in the sandbox. This
+    # header configures the sandbox into a negative testing state for
+    # transactions that include the merchant.
     # @param [String] paypal_request_id Optional parameter: The server stores
     # keys for 45 days.
     # @param [String] prefer Optional parameter: The preferred server response
-    # upon successful completion of the request. Value
-    # is:<ul><li><code>return=minimal</code>. The server returns a minimal
-    # response to optimize communication between the API caller and the server.
-    # A minimal response includes the <code>id</code>, <code>status</code> and
-    # HATEOAS links.</li><li><code>return=representation</code>. The server
-    # returns a complete resource representation, including the current state of
-    # the resource.</li></ul>
+    # upon successful completion of the request. Value is: return=minimal. The
+    # server returns a minimal response to optimize communication between the
+    # API caller and the server. A minimal response includes the id, status and
+    # HATEOAS links. return=representation. The server returns a complete
+    # resource representation, including the current state of the resource.
     # @param [String] paypal_auth_assertion Optional parameter: An
     # API-caller-provided JSON Web Token (JWT) assertion that identifies the
     # merchant. For details, see
     # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
-    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
-    # which a partner is managing the API calls on behalf of a merchant, the
-    # partner must identify the merchant using either a PayPal-Auth-Assertion
-    # header or an access token with target_subject.</blockquote>
+    # rtion). Note:For three party transactions in which a partner is managing
+    # the API calls on behalf of a merchant, the partner must identify the
+    # merchant using either a PayPal-Auth-Assertion header or an access token
+    # with target_subject.
     # @param [RefundRequest] body Optional parameter: Example:
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def captures_refund(options = {})
+    def refund_captured_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/v2/payments/captures/{capture_id}/refund',
@@ -339,6 +354,7 @@ module PaypalServerSdk
                    .template_param(new_parameter(options['capture_id'], key: 'capture_id')
                                     .should_encode(true))
                    .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .header_param(new_parameter(options['paypal_mock_response'], key: 'PayPal-Mock-Response'))
                    .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter(options['prefer'], key: 'Prefer'))
                    .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
@@ -385,22 +401,27 @@ module PaypalServerSdk
     # Shows details for a refund, by ID.
     # @param [String] refund_id Required parameter: The PayPal-generated ID for
     # the refund for which to show details.
+    # @param [String] paypal_mock_response Optional parameter: PayPal's REST API
+    # uses a request header to invoke negative testing in the sandbox. This
+    # header configures the sandbox into a negative testing state for
+    # transactions that include the merchant.
     # @param [String] paypal_auth_assertion Optional parameter: An
     # API-caller-provided JSON Web Token (JWT) assertion that identifies the
     # merchant. For details, see
     # [PayPal-Auth-Assertion](/docs/api/reference/api-requests/#paypal-auth-asse
-    # rtion).<blockquote><strong>Note:</strong>For three party transactions in
-    # which a partner is managing the API calls on behalf of a merchant, the
-    # partner must identify the merchant using either a PayPal-Auth-Assertion
-    # header or an access token with target_subject.</blockquote>
+    # rtion). Note:For three party transactions in which a partner is managing
+    # the API calls on behalf of a merchant, the partner must identify the
+    # merchant using either a PayPal-Auth-Assertion header or an access token
+    # with target_subject.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def refunds_get(options = {})
+    def get_refund(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v2/payments/refunds/{refund_id}',
                                      Server::DEFAULT)
                    .template_param(new_parameter(options['refund_id'], key: 'refund_id')
                                     .should_encode(true))
+                   .header_param(new_parameter(options['paypal_mock_response'], key: 'PayPal-Mock-Response'))
                    .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .auth(Single.new('Oauth2')))

data/lib/paypal_server_sdk/controllers/vault_controller.rb

@@ -8,19 +8,19 @@ module PaypalServerSdk
   class VaultController < BaseController
     # Creates a Payment Token from the given payment source and adds it to the
     # Vault of the associated customer.
-    # @param [String] paypal_request_id Required parameter: The server stores
-    # keys for 3 hours.
     # @param [PaymentTokenRequest] body Required parameter: Payment Token
     # creation with a financial instrument and an optional customer_id.
+    # @param [String] paypal_request_id Optional parameter: The server stores
+    # keys for 3 hours.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def payment_tokens_create(options = {})
+    def create_payment_token(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/v3/vault/payment-tokens',
                                      Server::DEFAULT)
-                   .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter('application/json', key: 'Content-Type'))
                    .body_param(new_parameter(options['body']))
+                   .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(Single.new('Oauth2')))
@@ -60,7 +60,7 @@ module PaypalServerSdk
     # boolean indicating total number of items (total_items) and pages
     # (total_pages) are expected to be returned in the response.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def customer_payment_tokens_get(options = {})
+    def list_customer_payment_tokens(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v3/vault/payment-tokens',
@@ -92,7 +92,7 @@ module PaypalServerSdk
     # with the payment token id.
     # @param [String] id Required parameter: ID of the payment token.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def payment_tokens_get(id)
+    def get_payment_token(id)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v3/vault/payment-tokens/{id}',
@@ -124,7 +124,7 @@ module PaypalServerSdk
     # Delete the payment token associated with the payment token id.
     # @param [String] id Required parameter: ID of the payment token.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def payment_tokens_delete(id)
+    def delete_payment_token(id)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::DELETE,
                                      '/v3/vault/payment-tokens/{id}',
@@ -150,20 +150,20 @@ module PaypalServerSdk
 
     # Creates a Setup Token from the given payment source and adds it to the
     # Vault of the associated customer.
-    # @param [String] paypal_request_id Required parameter: The server stores
-    # keys for 3 hours.
     # @param [SetupTokenRequest] body Required parameter: Setup Token creation
     # with a instrument type optional financial instrument details and
     # customer_id.
+    # @param [String] paypal_request_id Optional parameter: The server stores
+    # keys for 3 hours.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def setup_tokens_create(options = {})
+    def create_setup_token(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
                                      '/v3/vault/setup-tokens',
                                      Server::DEFAULT)
-                   .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter('application/json', key: 'Content-Type'))
                    .body_param(new_parameter(options['body']))
+                   .header_param(new_parameter(options['paypal_request_id'], key: 'PayPal-Request-Id'))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(Single.new('Oauth2')))
@@ -192,7 +192,7 @@ module PaypalServerSdk
     # associated with the setup token id.
     # @param [String] id Required parameter: ID of the setup token.
     # @return [ApiResponse]  the complete http response with raw body and status code.
-    def setup_tokens_get(id)
+    def get_setup_token(id)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
                                      '/v3/vault/setup-tokens/{id}',

data/lib/paypal_server_sdk/exceptions/api_exception.rb

@@ -6,5 +6,16 @@
 module PaypalServerSdk
   # Class for exceptions when there is a network error, status code error, etc.
   class APIException < CoreLibrary::ApiException
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status_code: #{@response_code}, reason: #{@reason}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status_code: #{@response_code.inspect}, reason: #{@reason.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/exceptions/error_exception.rb

@@ -67,5 +67,19 @@ module PaypalServerSdk
 
       @links = SKIP unless hash.key?('links')
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, message: #{@message}, debug_id: #{@debug_id}, details:"\
+      " #{@details}, links: #{@links}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, message: #{@message.inspect}, debug_id:"\
+      " #{@debug_id.inspect}, details: #{@details.inspect}, links: #{@links.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/exceptions/o_auth_provider_exception.rb

@@ -44,5 +44,19 @@ module PaypalServerSdk
         hash.key?('error_description') ? hash['error_description'] : SKIP
       @error_uri = hash.key?('error_uri') ? hash['error_uri'] : SKIP
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} error: #{@error}, error_description: #{@error_description}, error_uri:"\
+      " #{@error_uri}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} error: #{@error.inspect}, error_description: #{@error_description.inspect},"\
+      " error_uri: #{@error_uri.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/activity_timestamps.rb

@@ -12,17 +12,15 @@ module PaypalServerSdk
 
     # The date and time, in [Internet date and time
     # format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are
-    # required while fractional seconds are
-    # optional.<blockquote><strong>Note:</strong> The regular expression
-    # provides guidance but does not reject all invalid dates.</blockquote>
+    # required while fractional seconds are optional. Note: The regular
+    # expression provides guidance but does not reject all invalid dates.
     # @return [String]
     attr_accessor :create_time
 
     # The date and time, in [Internet date and time
     # format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are
-    # required while fractional seconds are
-    # optional.<blockquote><strong>Note:</strong> The regular expression
-    # provides guidance but does not reject all invalid dates.</blockquote>
+    # required while fractional seconds are optional. Note: The regular
+    # expression provides guidance but does not reject all invalid dates.
     # @return [String]
     attr_accessor :update_time
 
@@ -64,5 +62,18 @@ module PaypalServerSdk
       ActivityTimestamps.new(create_time: create_time,
                              update_time: update_time)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} create_time: #{@create_time}, update_time: #{@update_time}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} create_time: #{@create_time.inspect}, update_time:"\
+      " #{@update_time.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/address.rb

@@ -30,10 +30,9 @@ module PaypalServerSdk
 
     # The highest-level sub-division in a country, which is usually a province,
     # state, or ISO-3166-2 subdivision. This data is formatted for postal
-    # delivery, for example, `CA` and not `California`. Value, by country,
-    # is:<ul><li>UK. A county.</li><li>US. A state.</li><li>Canada. A
-    # province.</li><li>Japan. A prefecture.</li><li>Switzerland. A
-    # *kanton*.</li></ul>
+    # delivery, for example, `CA` and not `California`. Value, by country, is:
+    # UK. A county. US. A state. Canada. A province. Japan. A prefecture.
+    # Switzerland. A *kanton*.
     # @return [String]
     attr_accessor :admin_area_1
 
@@ -44,11 +43,10 @@ module PaypalServerSdk
     attr_accessor :postal_code
 
     # The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that
-    # identifies the country or region.<blockquote><strong>Note:</strong> The
-    # country code for Great Britain is <code>GB</code> and not <code>UK</code>
-    # as used in the top-level domain names for that country. Use the `C2`
-    # country code for China worldwide for comparable uncontrolled price (CUP)
-    # method, bank card, and cross-border transactions.</blockquote>
+    # identifies the country or region. Note: The country code for Great Britain
+    # is GB and not UK as used in the top-level domain names for that country.
+    # Use the `C2` country code for China worldwide for comparable uncontrolled
+    # price (CUP) method, bank card, and cross-border transactions.
     # @return [String]
     attr_accessor :country_code
 
@@ -112,5 +110,22 @@ module PaypalServerSdk
                   admin_area_1: admin_area_1,
                   postal_code: postal_code)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} address_line_1: #{@address_line_1}, address_line_2: #{@address_line_2},"\
+      " admin_area_2: #{@admin_area_2}, admin_area_1: #{@admin_area_1}, postal_code:"\
+      " #{@postal_code}, country_code: #{@country_code}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} address_line_1: #{@address_line_1.inspect}, address_line_2:"\
+      " #{@address_line_2.inspect}, admin_area_2: #{@admin_area_2.inspect}, admin_area_1:"\
+      " #{@admin_area_1.inspect}, postal_code: #{@postal_code.inspect}, country_code:"\
+      " #{@country_code.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/amount_breakdown.rb

@@ -111,5 +111,22 @@ module PaypalServerSdk
                           shipping_discount: shipping_discount,
                           discount: discount)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} item_total: #{@item_total}, shipping: #{@shipping}, handling: #{@handling},"\
+      " tax_total: #{@tax_total}, insurance: #{@insurance}, shipping_discount:"\
+      " #{@shipping_discount}, discount: #{@discount}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} item_total: #{@item_total.inspect}, shipping: #{@shipping.inspect},"\
+      " handling: #{@handling.inspect}, tax_total: #{@tax_total.inspect}, insurance:"\
+      " #{@insurance.inspect}, shipping_discount: #{@shipping_discount.inspect}, discount:"\
+      " #{@discount.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/amount_with_breakdown.rb

@@ -6,12 +6,11 @@
 module PaypalServerSdk
   # The total order amount with an optional breakdown that provides details,
   # such as the total item amount, total tax amount, shipping, handling,
-  # insurance, and discounts, if any.<br/>If you specify `amount.breakdown`, the
+  # insurance, and discounts, if any. If you specify `amount.breakdown`, the
   # amount equals `item_total` plus `tax_total` plus `shipping` plus `handling`
-  # plus `insurance` minus `shipping_discount` minus discount.<br/>The amount
-  # must be a positive number. For listed of supported currencies and decimal
-  # precision, see the PayPal REST APIs <a
-  # href="/docs/integration/direct/rest/currency-codes/">Currency Codes</a>.
+  # plus `insurance` minus `shipping_discount` minus discount. The amount must
+  # be a positive number. For listed of supported currencies and decimal
+  # precision, see the PayPal REST APIs Currency Codes.
   class AmountWithBreakdown < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -21,10 +20,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :currency_code
 
-    # The value, which might be:<ul><li>An integer for currencies like `JPY`
-    # that are not typically fractional.</li><li>A decimal fraction for
-    # currencies like `TND` that are subdivided into thousandths.</li></ul>For
-    # the required number of decimal places for a currency code, see [Currency
+    # The value, which might be: An integer for currencies like `JPY` that are
+    # not typically fractional. A decimal fraction for currencies like `TND`
+    # that are subdivided into thousandths. For the required number of decimal
+    # places for a currency code, see [Currency
     # Codes](/api/rest/reference/currency-codes/).
     # @return [String]
     attr_accessor :value
@@ -76,5 +75,19 @@ module PaypalServerSdk
                               value: value,
                               breakdown: breakdown)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} currency_code: #{@currency_code}, value: #{@value}, breakdown:"\
+      " #{@breakdown}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} currency_code: #{@currency_code.inspect}, value: #{@value.inspect},"\
+      " breakdown: #{@breakdown.inspect}>"
+    end
   end
 end