paypal-server-sdk 0.6.0 → 0.7.0

data/lib/paypal_server_sdk/controllers/payments_controller.rb

@@ -9,14 +9,28 @@ 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). 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(authorization_id)
+    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(authorization_id, key: 'authorization_id')
+                   .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')))
         .response(new_response_handler
@@ -27,10 +41,6 @@ module PaypalServerSdk
                                  'Authentication failed due to missing authorization header, or'\
                                   ' invalid authentication credentials.',
                                  ErrorException)
-                    .local_error('403',
-                                 'The request failed because the caller has insufficient'\
-                                  ' permissions.',
-                                 ErrorException)
                     .local_error('404',
                                  'The request failed because the resource does not exist.',
                                  ErrorException)
@@ -46,19 +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). 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',
@@ -66,8 +86,10 @@ 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'))
                    .body_param(new_parameter(options['body']))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
@@ -108,40 +130,55 @@ module PaypalServerSdk
         .execute
     end
 
-    # Voids, or cancels, an authorized payment, by ID. You cannot void an
-    # authorized payment that has been fully captured.
+    # 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.
+    # 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 void.
+    # 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: 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>
-    # @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>
+    # 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_void(options = {})
+    def reauthorize_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/v2/payments/authorizations/{authorization_id}/void',
+                                     '/v2/payments/authorizations/{authorization_id}/reauthorize',
                                      Server::DEFAULT)
                    .template_param(new_parameter(options['authorization_id'], key: 'authorization_id')
                                     .should_encode(true))
-                   .header_param(new_parameter(options['paypal_auth_assertion'], key: 'PayPal-Auth-Assertion'))
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .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'))
+                   .body_param(new_parameter(options['body']))
                    .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
-                    .is_nullable_response(true)
                     .deserializer(APIHelper.method(:custom_type_deserializer))
                     .deserialize_into(PaymentAuthorization.method(:from_hash))
                     .is_api_response(true)
@@ -153,17 +190,9 @@ module PaypalServerSdk
                                  'Authentication failed due to missing authorization header, or'\
                                   ' invalid authentication credentials.',
                                  ErrorException)
-                    .local_error('403',
-                                 'The request failed because the caller has insufficient'\
-                                  ' permissions.',
-                                 ErrorException)
                     .local_error('404',
                                  'The request failed because the resource does not exist.',
                                  ErrorException)
-                    .local_error('409',
-                                 'The request failed because a previous call for the given'\
-                                  ' resource is in progress.',
-                                 ErrorException)
                     .local_error('422',
                                  'The request failed because it either is semantically incorrect'\
                                   ' or failed business validation.',
@@ -177,56 +206,49 @@ module PaypalServerSdk
         .execute
     end
 
-    # 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>
+    # Voids, or cancels, an authorized payment, by ID. You cannot void an
+    # authorized payment that has been fully captured.
     # @param [String] authorization_id Required parameter: The PayPal-generated
-    # ID for the authorized payment to reauthorize.
+    # 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). 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>
-    # @param [ReauthorizeRequest] body Optional parameter: Example:
+    # 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_reauthorize(options = {})
+    def void_payment(options = {})
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/v2/payments/authorizations/{authorization_id}/reauthorize',
+                                     '/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('application/json', key: 'Content-Type'))
+                   .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'))
-                   .body_param(new_parameter(options['body']))
                    .header_param(new_parameter('application/json', key: 'accept'))
-                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
+                    .is_nullable_response(true)
                     .deserializer(APIHelper.method(:custom_type_deserializer))
                     .deserialize_into(PaymentAuthorization.method(:from_hash))
                     .is_api_response(true)
-                    .local_error('400',
-                                 'The request failed because it is not well-formed or is'\
-                                  ' syntactically incorrect or violates schema.',
-                                 ErrorException)
                     .local_error('401',
                                  'Authentication failed due to missing authorization header, or'\
                                   ' invalid authentication credentials.',
@@ -238,6 +260,10 @@ module PaypalServerSdk
                     .local_error('404',
                                  'The request failed because the resource does not exist.',
                                  ErrorException)
+                    .local_error('409',
+                                 'The request failed because a previous call for the given'\
+                                  ' resource is in progress.',
+                                 ErrorException)
                     .local_error('422',
                                  'The request failed because it either is semantically incorrect'\
                                   ' or failed business validation.',
@@ -254,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
@@ -289,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',
@@ -321,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'))
@@ -367,14 +401,28 @@ 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). 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(refund_id)
+    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(refund_id, key: 'refund_id')
+                   .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')))
         .response(new_response_handler

data/lib/paypal_server_sdk/controllers/vault_controller.rb

@@ -6,6 +6,48 @@
 module PaypalServerSdk
   # VaultController
   class VaultController < BaseController
+    # Creates a Payment Token from the given payment source and adds it to the
+    # Vault of the associated customer.
+    # @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 create_payment_token(options = {})
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v3/vault/payment-tokens',
+                                     Server::DEFAULT)
+                   .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')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(PaymentTokenResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'Request is not well-formed, syntactically incorrect, or'\
+                                  ' violates schema.',
+                                 ErrorException)
+                    .local_error('403',
+                                 'Authorization failed due to insufficient permissions.',
+                                 ErrorException)
+                    .local_error('404',
+                                 'Request contains reference to resources that do not exist.',
+                                 ErrorException)
+                    .local_error('422',
+                                 'The requested action could not be performed, semantically'\
+                                  ' incorrect, or failed business validation.',
+                                 ErrorException)
+                    .local_error('500',
+                                 'An internal server error has occurred.',
+                                 ErrorException))
+        .execute
+    end
+
     # Returns all payment tokens for a customer.
     # @param [String] customer_id Required parameter: A unique identifier
     # representing a specific customer in merchant's/partner's system or
@@ -18,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',
@@ -50,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}',
@@ -79,27 +121,19 @@ module PaypalServerSdk
         .execute
     end
 
-    # 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.
+    # 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_create(options = {})
+    def delete_payment_token(id)
       new_api_call_builder
-        .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/v3/vault/payment-tokens',
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v3/vault/payment-tokens/{id}',
                                      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('application/json', key: 'accept'))
-                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .template_param(new_parameter(id, key: 'id')
+                                    .should_encode(true))
                    .auth(Single.new('Oauth2')))
         .response(new_response_handler
-                    .deserializer(APIHelper.method(:custom_type_deserializer))
-                    .deserialize_into(PaymentTokenResponse.method(:from_hash))
+                    .is_response_void(true)
                     .is_api_response(true)
                     .local_error('400',
                                  'Request is not well-formed, syntactically incorrect, or'\
@@ -108,13 +142,6 @@ module PaypalServerSdk
                     .local_error('403',
                                  'Authorization failed due to insufficient permissions.',
                                  ErrorException)
-                    .local_error('404',
-                                 'Request contains reference to resources that do not exist.',
-                                 ErrorException)
-                    .local_error('422',
-                                 'The requested action could not be performed, semantically'\
-                                  ' incorrect, or failed business validation.',
-                                 ErrorException)
                     .local_error('500',
                                  'An internal server error has occurred.',
                                  ErrorException))
@@ -123,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')))
@@ -161,38 +188,11 @@ module PaypalServerSdk
         .execute
     end
 
-    # 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)
-      new_api_call_builder
-        .request(new_request_builder(HttpMethodEnum::DELETE,
-                                     '/v3/vault/payment-tokens/{id}',
-                                     Server::DEFAULT)
-                   .template_param(new_parameter(id, key: 'id')
-                                    .should_encode(true))
-                   .auth(Single.new('Oauth2')))
-        .response(new_response_handler
-                    .is_response_void(true)
-                    .is_api_response(true)
-                    .local_error('400',
-                                 'Request is not well-formed, syntactically incorrect, or'\
-                                  ' violates schema.',
-                                 ErrorException)
-                    .local_error('403',
-                                 'Authorization failed due to insufficient permissions.',
-                                 ErrorException)
-                    .local_error('500',
-                                 'An internal server error has occurred.',
-                                 ErrorException))
-        .execute
-    end
-
     # Returns a readable representation of temporarily vaulted payment source
     # 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