first_data_gateway 1.1.0 → 1.2.0

data/lib/openapi_client/api/payment_api.rb

@@ -1,9 +1,9 @@
 =begin
 #Payment Gateway API Specification.
 
-#Payment Gateway API for payment processing. Version 6.4.0.20181018.001 
+#The documentation here is designed to provide all of the technical guidance required to consume and integrate with our APIs for payment processing. To learn more about our APIs please visit https://docs.firstdata.com/org/gateway.
 
-OpenAPI spec version: 6.4.0.20181018.001
+OpenAPI spec version: 6.6.0.20190329.001
 
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: unset
@@ -21,34 +21,34 @@ module OpenapiClient
     end
     # Update a 3DSecure or UnionPay payment and continue processing.
     # Use this to handle a 3DSecure redirect response or UnionPay authentication, updating the transaction and continuing processing.
-    # @param content_type content type
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param authentication_response_verification_request 
+    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId.
+    # @param authentication_verification_request Accepted request types: Secure3dAuthenticationVerificationRequest and UnionPayAuthenticationVerificationRequest.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
     # @return [TransactionResponse]
-    def finalize_secure_transaction(content_type, client_request_id, api_key, timestamp, transaction_id, authentication_response_verification_request, opts = {})
-      data, _status_code, _headers = finalize_secure_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, authentication_response_verification_request, opts)
+    def finalize_secure_transaction(content_type, client_request_id, api_key, timestamp, transaction_id, authentication_verification_request, opts = {})
+      data, _status_code, _headers = finalize_secure_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, authentication_verification_request, opts)
       data
     end
 
     # Update a 3DSecure or UnionPay payment and continue processing.
     # Use this to handle a 3DSecure redirect response or UnionPay authentication, updating the transaction and continuing processing.
-    # @param content_type content type
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param authentication_response_verification_request 
+    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId.
+    # @param authentication_verification_request Accepted request types: Secure3dAuthenticationVerificationRequest and UnionPayAuthenticationVerificationRequest.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
     # @return [Array<(TransactionResponse, Fixnum, Hash)>] TransactionResponse data, response status code and response headers
-    def finalize_secure_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, authentication_response_verification_request, opts = {})
+    def finalize_secure_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, authentication_verification_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: PaymentApi.finalize_secure_transaction ...'
       end
@@ -76,12 +76,12 @@ module OpenapiClient
       if @api_client.config.client_side_validation && transaction_id.nil?
         fail ArgumentError, "Missing the required parameter 'transaction_id' when calling PaymentApi.finalize_secure_transaction"
       end
-      # verify the required parameter 'authentication_response_verification_request' is set
-      if @api_client.config.client_side_validation && authentication_response_verification_request.nil?
-        fail ArgumentError, "Missing the required parameter 'authentication_response_verification_request' when calling PaymentApi.finalize_secure_transaction"
+      # verify the required parameter 'authentication_verification_request' is set
+      if @api_client.config.client_side_validation && authentication_verification_request.nil?
+        fail ArgumentError, "Missing the required parameter 'authentication_verification_request' when calling PaymentApi.finalize_secure_transaction"
       end
       # resource path
-      local_var_path = '/v1/payments/{transaction-id}'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
+      local_var_path = '/payments/{transaction-id}'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
 
       # query parameters
       query_params = {}
@@ -103,7 +103,7 @@ module OpenapiClient
       form_params = {}
 
       # http body (model)
-      post_body = @api_client.object_to_http_body(authentication_response_verification_request)
+      post_body = @api_client.object_to_http_body(authentication_verification_request)
       auth_names = []
       data, status_code, headers = @api_client.call_api(:PATCH, local_var_path,
         :header_params => header_params,
@@ -120,143 +120,40 @@ module OpenapiClient
       return data, status_code, headers
     end
 
-    # Capture/complete a transaction.
-    # Used to capture/complete an existing transaction. Partial postauths are allowed.
-    # @param content_type content type
-    # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
-    # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param secondary_transaction 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
-    # @return [TransactionResponse]
-    def perform_payment_post_authorisation(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts = {})
-      data, _status_code, _headers = perform_payment_post_authorisation_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts)
-      data
-    end
-
-    # Capture/complete a transaction.
-    # Used to capture/complete an existing transaction. Partial postauths are allowed.
-    # @param content_type content type
-    # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
-    # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param secondary_transaction 
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
-    # @return [Array<(TransactionResponse, Fixnum, Hash)>] TransactionResponse data, response status code and response headers
-    def perform_payment_post_authorisation_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PaymentApi.perform_payment_post_authorisation ...'
-      end
-      # verify the required parameter 'content_type' is set
-      if @api_client.config.client_side_validation && content_type.nil?
-        fail ArgumentError, "Missing the required parameter 'content_type' when calling PaymentApi.perform_payment_post_authorisation"
-      end
-      # verify enum value
-      if @api_client.config.client_side_validation && !['application/json'].include?(content_type)
-        fail ArgumentError, "invalid value for 'content_type', must be one of application/json"
-      end
-      # verify the required parameter 'client_request_id' is set
-      if @api_client.config.client_side_validation && client_request_id.nil?
-        fail ArgumentError, "Missing the required parameter 'client_request_id' when calling PaymentApi.perform_payment_post_authorisation"
-      end
-      # verify the required parameter 'api_key' is set
-      if @api_client.config.client_side_validation && api_key.nil?
-        fail ArgumentError, "Missing the required parameter 'api_key' when calling PaymentApi.perform_payment_post_authorisation"
-      end
-      # verify the required parameter 'timestamp' is set
-      if @api_client.config.client_side_validation && timestamp.nil?
-        fail ArgumentError, "Missing the required parameter 'timestamp' when calling PaymentApi.perform_payment_post_authorisation"
-      end
-      # verify the required parameter 'transaction_id' is set
-      if @api_client.config.client_side_validation && transaction_id.nil?
-        fail ArgumentError, "Missing the required parameter 'transaction_id' when calling PaymentApi.perform_payment_post_authorisation"
-      end
-      # verify the required parameter 'secondary_transaction' is set
-      if @api_client.config.client_side_validation && secondary_transaction.nil?
-        fail ArgumentError, "Missing the required parameter 'secondary_transaction' when calling PaymentApi.perform_payment_post_authorisation"
-      end
-      # resource path
-      local_var_path = '/v1/payments/{transaction-id}/postauth'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
-
-      # query parameters
-      query_params = {}
-      query_params[:'storeId'] = opts[:'store_id'] if !opts[:'store_id'].nil?
-
-      # header parameters
-      header_params = {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
-      # HTTP header 'Content-Type'
-      # header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
-      # header_params[:'Content-Type'] = content_type
-      header_params[:'Client-Request-Id'] = client_request_id
-      header_params[:'Api-Key'] = api_key
-      header_params[:'Timestamp'] = timestamp
-      header_params[:'Message-Signature'] = opts[:'message_signature'] if !opts[:'message_signature'].nil?
-      header_params[:'Region'] = opts[:'region'] if !opts[:'region'].nil?
-
-      # form parameters
-      form_params = {}
-
-      # http body (model)
-      post_body = @api_client.object_to_http_body(secondary_transaction)
-      auth_names = []
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => 'TransactionResponse',
-        :default_error_type => 'ErrorResponse')
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: PaymentApi#perform_payment_post_authorisation\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Generate a primary transaction.
-    # Use this to originate a financial transaction, like a sale, preauthorization, or credit.
-    # @param content_type content type
+    # Use this to originate a financial transaction like a sale, preauthorization, or credit.
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param primary_transaction Primary Transaction request
+    # @param primary_transaction Accepted request types: AliPaySaleTransaction, ChinaPnRSaleTransaction, PaymentCardCreditTransaction, PaymentCardForcedTicketTransaction, PaymentCardSaleTransaction, PaymentCardPreAuthTransaction, PaymentCardPayerAuthTransaction, PaymentTokenCreditTransaction, PaymentTokenPreAuthTransaction, PaymentTokenSaleTransaction, PaypalCreditTransaction, and SepaSaleTransaction.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
     # @return [TransactionResponse]
-    def primary_payment_transaction(content_type, client_request_id, api_key, timestamp, primary_transaction, opts = {})
-      data, _status_code, _headers = primary_payment_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, primary_transaction, opts)
+    def submit_primary_transaction(content_type, client_request_id, api_key, timestamp, primary_transaction, opts = {})
+      data, _status_code, _headers = submit_primary_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, primary_transaction, opts)
       data
     end
 
     # Generate a primary transaction.
-    # Use this to originate a financial transaction, like a sale, preauthorization, or credit.
-    # @param content_type content type
+    # Use this to originate a financial transaction like a sale, preauthorization, or credit.
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param primary_transaction Primary Transaction request
+    # @param primary_transaction Accepted request types: AliPaySaleTransaction, ChinaPnRSaleTransaction, PaymentCardCreditTransaction, PaymentCardForcedTicketTransaction, PaymentCardSaleTransaction, PaymentCardPreAuthTransaction, PaymentCardPayerAuthTransaction, PaymentTokenCreditTransaction, PaymentTokenPreAuthTransaction, PaymentTokenSaleTransaction, PaypalCreditTransaction, and SepaSaleTransaction.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
     # @return [Array<(TransactionResponse, Fixnum, Hash)>] TransactionResponse data, response status code and response headers
-    def primary_payment_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, primary_transaction, opts = {})
+    def submit_primary_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, primary_transaction, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PaymentApi.primary_payment_transaction ...'
+        @api_client.config.logger.debug 'Calling API: PaymentApi.submit_primary_transaction ...'
       end
       # verify the required parameter 'content_type' is set
       if @api_client.config.client_side_validation && content_type.nil?
-        fail ArgumentError, "Missing the required parameter 'content_type' when calling PaymentApi.primary_payment_transaction"
+        fail ArgumentError, "Missing the required parameter 'content_type' when calling PaymentApi.submit_primary_transaction"
       end
       # verify enum value
       if @api_client.config.client_side_validation && !['application/json'].include?(content_type)
@@ -264,22 +161,22 @@ module OpenapiClient
       end
       # verify the required parameter 'client_request_id' is set
       if @api_client.config.client_side_validation && client_request_id.nil?
-        fail ArgumentError, "Missing the required parameter 'client_request_id' when calling PaymentApi.primary_payment_transaction"
+        fail ArgumentError, "Missing the required parameter 'client_request_id' when calling PaymentApi.submit_primary_transaction"
       end
       # verify the required parameter 'api_key' is set
       if @api_client.config.client_side_validation && api_key.nil?
-        fail ArgumentError, "Missing the required parameter 'api_key' when calling PaymentApi.primary_payment_transaction"
+        fail ArgumentError, "Missing the required parameter 'api_key' when calling PaymentApi.submit_primary_transaction"
       end
       # verify the required parameter 'timestamp' is set
       if @api_client.config.client_side_validation && timestamp.nil?
-        fail ArgumentError, "Missing the required parameter 'timestamp' when calling PaymentApi.primary_payment_transaction"
+        fail ArgumentError, "Missing the required parameter 'timestamp' when calling PaymentApi.submit_primary_transaction"
       end
       # verify the required parameter 'primary_transaction' is set
       if @api_client.config.client_side_validation && primary_transaction.nil?
-        fail ArgumentError, "Missing the required parameter 'primary_transaction' when calling PaymentApi.primary_payment_transaction"
+        fail ArgumentError, "Missing the required parameter 'primary_transaction' when calling PaymentApi.submit_primary_transaction"
       end
       # resource path
-      local_var_path = '/v1/payments'
+      local_var_path = '/payments'
 
       # query parameters
       query_params = {}
@@ -313,49 +210,49 @@ module OpenapiClient
         :default_error_type => 'ErrorResponse',
         :error_type => 'TransactionErrorResponse')
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: PaymentApi#primary_payment_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PaymentApi#submit_primary_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Return/refund a transaction.
-    # Use this to return/refund an existing transaction.  Partial returns are allowed.
-    # @param content_type content type
+    # Perform a secondary transaction.
+    # Use this to perform a void, postAuth or return secondary transaction. Partial postAuths and returns are allowed.
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param secondary_transaction 
+    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId.
+    # @param secondary_transaction Accepted request types: PostAuthTransaction, VoidTransaction, and ReturnTransaction.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
+    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app.
     # @return [TransactionResponse]
-    def return_transaction(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts = {})
-      data, _status_code, _headers = return_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts)
+    def submit_secondary_transaction(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts = {})
+      data, _status_code, _headers = submit_secondary_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts)
       data
     end
 
-    # Return/refund a transaction.
-    # Use this to return/refund an existing transaction.  Partial returns are allowed.
-    # @param content_type content type
+    # Perform a secondary transaction.
+    # Use this to perform a void, postAuth or return secondary transaction. Partial postAuths and returns are allowed.
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param secondary_transaction 
+    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId.
+    # @param secondary_transaction Accepted request types: PostAuthTransaction, VoidTransaction, and ReturnTransaction.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
+    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app.
     # @return [Array<(TransactionResponse, Fixnum, Hash)>] TransactionResponse data, response status code and response headers
-    def return_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts = {})
+    def submit_secondary_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, secondary_transaction, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PaymentApi.return_transaction ...'
+        @api_client.config.logger.debug 'Calling API: PaymentApi.submit_secondary_transaction ...'
       end
       # verify the required parameter 'content_type' is set
       if @api_client.config.client_side_validation && content_type.nil?
-        fail ArgumentError, "Missing the required parameter 'content_type' when calling PaymentApi.return_transaction"
+        fail ArgumentError, "Missing the required parameter 'content_type' when calling PaymentApi.submit_secondary_transaction"
       end
       # verify enum value
       if @api_client.config.client_side_validation && !['application/json'].include?(content_type)
@@ -363,26 +260,26 @@ module OpenapiClient
       end
       # verify the required parameter 'client_request_id' is set
       if @api_client.config.client_side_validation && client_request_id.nil?
-        fail ArgumentError, "Missing the required parameter 'client_request_id' when calling PaymentApi.return_transaction"
+        fail ArgumentError, "Missing the required parameter 'client_request_id' when calling PaymentApi.submit_secondary_transaction"
       end
       # verify the required parameter 'api_key' is set
       if @api_client.config.client_side_validation && api_key.nil?
-        fail ArgumentError, "Missing the required parameter 'api_key' when calling PaymentApi.return_transaction"
+        fail ArgumentError, "Missing the required parameter 'api_key' when calling PaymentApi.submit_secondary_transaction"
       end
       # verify the required parameter 'timestamp' is set
       if @api_client.config.client_side_validation && timestamp.nil?
-        fail ArgumentError, "Missing the required parameter 'timestamp' when calling PaymentApi.return_transaction"
+        fail ArgumentError, "Missing the required parameter 'timestamp' when calling PaymentApi.submit_secondary_transaction"
       end
       # verify the required parameter 'transaction_id' is set
       if @api_client.config.client_side_validation && transaction_id.nil?
-        fail ArgumentError, "Missing the required parameter 'transaction_id' when calling PaymentApi.return_transaction"
+        fail ArgumentError, "Missing the required parameter 'transaction_id' when calling PaymentApi.submit_secondary_transaction"
       end
       # verify the required parameter 'secondary_transaction' is set
       if @api_client.config.client_side_validation && secondary_transaction.nil?
-        fail ArgumentError, "Missing the required parameter 'secondary_transaction' when calling PaymentApi.return_transaction"
+        fail ArgumentError, "Missing the required parameter 'secondary_transaction' when calling PaymentApi.submit_secondary_transaction"
       end
       # resource path
-      local_var_path = '/v1/payments/{transaction-id}/return'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
+      local_var_path = '/payments/{transaction-id}'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
 
       # query parameters
       query_params = {}
@@ -417,22 +314,22 @@ module OpenapiClient
         :default_error_type => 'ErrorResponse',
         :error_type => 'TransactionErrorResponse')
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: PaymentApi#return_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: PaymentApi#submit_secondary_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
     # Retrieve the state of a transaction.
     # Use this query to get the current state of an existing transaction.
-    # @param content_type content type
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
+    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
+    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app.
     # @return [TransactionResponse]
     def transaction_inquiry(content_type, client_request_id, api_key, timestamp, transaction_id, opts = {})
       data, _status_code, _headers = transaction_inquiry_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, opts)
@@ -441,15 +338,15 @@ module OpenapiClient
 
     # Retrieve the state of a transaction.
     # Use this query to get the current state of an existing transaction.
-    # @param content_type content type
+    # @param content_type Content type.
     # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
+    # @param api_key Key given to merchant after boarding associating their requests with the appropriate app in Apigee.
     # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
+    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
+    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
+    # @option opts [String] :region Indicates the region where the client wants the transaction to be processed. This will override the default processing region identified for the client. Available options are argentina, brazil, germany, india and northamerica. Region specific store setup and APIGEE boarding is required in order to use an alternate region for processing.
+    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app.
     # @return [Array<(TransactionResponse, Fixnum, Hash)>] TransactionResponse data, response status code and response headers
     def transaction_inquiry_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, opts = {})
       if @api_client.config.debugging
@@ -480,7 +377,7 @@ module OpenapiClient
         fail ArgumentError, "Missing the required parameter 'transaction_id' when calling PaymentApi.transaction_inquiry"
       end
       # resource path
-      local_var_path = '/v1/payments/{transaction-id}'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
+      local_var_path = '/payments/{transaction-id}'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
 
       # query parameters
       query_params = {}
@@ -518,101 +415,5 @@ module OpenapiClient
       return data, status_code, headers
     end
 
-    # Reverse a previous action on an existing transaction.
-    # Use this to reverse a postauth/completion, credit, preauth, or sale.
-    # @param content_type content type
-    # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
-    # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
-    # @return [TransactionResponse]
-    def void_transaction(content_type, client_request_id, api_key, timestamp, transaction_id, opts = {})
-      data, _status_code, _headers = void_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, opts)
-      data
-    end
-
-    # Reverse a previous action on an existing transaction.
-    # Use this to reverse a postauth/completion, credit, preauth, or sale.
-    # @param content_type content type
-    # @param client_request_id A client-generated ID for request tracking and signature creation, unique per request.  This is also used for idempotency control. We recommend 128-bit UUID format.
-    # @param api_key 
-    # @param timestamp Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).
-    # @param transaction_id Gateway transaction identifier as returned in the parameter ipgTransactionId
-    # @param [Hash] opts the optional parameters
-    # @option opts [String] :message_signature Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256  algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.
-    # @option opts [String] :region The region where client wants to process the transaction
-    # @option opts [String] :store_id An optional outlet ID for clients that support multiple stores in the same developer app
-    # @return [Array<(TransactionResponse, Fixnum, Hash)>] TransactionResponse data, response status code and response headers
-    def void_transaction_with_http_info(content_type, client_request_id, api_key, timestamp, transaction_id, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PaymentApi.void_transaction ...'
-      end
-      # verify the required parameter 'content_type' is set
-      if @api_client.config.client_side_validation && content_type.nil?
-        fail ArgumentError, "Missing the required parameter 'content_type' when calling PaymentApi.void_transaction"
-      end
-      # verify enum value
-      if @api_client.config.client_side_validation && !['application/json'].include?(content_type)
-        fail ArgumentError, "invalid value for 'content_type', must be one of application/json"
-      end
-      # verify the required parameter 'client_request_id' is set
-      if @api_client.config.client_side_validation && client_request_id.nil?
-        fail ArgumentError, "Missing the required parameter 'client_request_id' when calling PaymentApi.void_transaction"
-      end
-      # verify the required parameter 'api_key' is set
-      if @api_client.config.client_side_validation && api_key.nil?
-        fail ArgumentError, "Missing the required parameter 'api_key' when calling PaymentApi.void_transaction"
-      end
-      # verify the required parameter 'timestamp' is set
-      if @api_client.config.client_side_validation && timestamp.nil?
-        fail ArgumentError, "Missing the required parameter 'timestamp' when calling PaymentApi.void_transaction"
-      end
-      # verify the required parameter 'transaction_id' is set
-      if @api_client.config.client_side_validation && transaction_id.nil?
-        fail ArgumentError, "Missing the required parameter 'transaction_id' when calling PaymentApi.void_transaction"
-      end
-      # resource path
-      local_var_path = '/v1/payments/{transaction-id}/void'.sub('{' + 'transaction-id' + '}', transaction_id.to_s)
-
-      # query parameters
-      query_params = {}
-      query_params[:'storeId'] = opts[:'store_id'] if !opts[:'store_id'].nil?
-
-      # header parameters
-      header_params = {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
-      # header_params[:'Content-Type'] = content_type
-      header_params[:'Client-Request-Id'] = client_request_id
-      header_params[:'Api-Key'] = api_key
-      header_params[:'Timestamp'] = timestamp
-      header_params[:'Message-Signature'] = opts[:'message_signature'] if !opts[:'message_signature'].nil?
-      header_params[:'Region'] = opts[:'region'] if !opts[:'region'].nil?
-
-      # form parameters
-      form_params = {}
-
-      # http body (model)
-      post_body = nil
-      auth_names = []
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => 'TransactionResponse',
-        :default_error_type => 'ErrorResponse',
-        :error_type => 'TransactionErrorResponse')
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: PaymentApi#void_transaction\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
   end
 end