#
# This class was auto-generated from the API references found at
# https://epayments-api.developer-ingenico.com/s2sapi/v1/
#
require 'ingenico/connect/sdk/api_resource'
require 'ingenico/connect/sdk/response_exception'
require 'ingenico/connect/sdk/domain/dispute/dispute_response'
require 'ingenico/connect/sdk/domain/dispute/upload_dispute_file_response'
require 'ingenico/connect/sdk/domain/errors/error_response'
module Ingenico::Connect::SDK
module Merchant
module Disputes
# Disputes client. Thread-safe.
class DisputesClient < Ingenico::Connect::SDK::ApiResource
# @param parent [Ingenico::Connect::SDK::ApiResource]
# @param path_context [Hash]
def initialize(parent, path_context)
super(parent, path_context)
end
# Resource /!{merchantId}/disputes/!{disputeId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/get.html Get dispute}
# @param dispute_id [String]
# @param context [Ingenico::Connect::SDK::CallContext]
# @return [Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse]
# @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
# @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
# @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
# @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
# or there was a conflict (HTTP status code 404, 409 or 410)
# @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
# the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
# or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
# @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
def get(dispute_id, context=nil)
path_context = {
'disputeId'.freeze => dispute_id,
}
uri = instantiate_uri('/v1/{merchantId}/disputes/{disputeId}', path_context)
return @communicator.get(
uri,
client_headers,
nil,
Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse,
context)
rescue ResponseException => e
error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
error_object = @communicator.marshaller.unmarshal(e.body, error_type)
raise create_exception(e.status_code, e.body, error_object, context)
end
# Resource /!{merchantId}/disputes/!{disputeId}/submit - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/submit.html Submit dispute}
# @param dispute_id [String]
# @param context [Ingenico::Connect::SDK::CallContext]
# @return [Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse]
# @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
# @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
# @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
# @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
# or there was a conflict (HTTP status code 404, 409 or 410)
# @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
# the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
# or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
# @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
def submit(dispute_id, context=nil)
path_context = {
'disputeId'.freeze => dispute_id,
}
uri = instantiate_uri('/v1/{merchantId}/disputes/{disputeId}/submit', path_context)
return @communicator.post(
uri,
client_headers,
nil,
nil,
Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse,
context)
rescue ResponseException => e
error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
error_object = @communicator.marshaller.unmarshal(e.body, error_type)
raise create_exception(e.status_code, e.body, error_object, context)
end
# Resource /!{merchantId}/disputes/!{disputeId}/cancel - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/disputes/cancel.html Cancel dispute}
# @param dispute_id [String]
# @param context [Ingenico::Connect::SDK::CallContext]
# @return [Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse]
# @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
# @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
# @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
# @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
# or there was a conflict (HTTP status code 404, 409 or 410)
# @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
# the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
# or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
# @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
def cancel(dispute_id, context=nil)
path_context = {
'disputeId'.freeze => dispute_id,
}
uri = instantiate_uri('/v1/{merchantId}/disputes/{disputeId}/cancel', path_context)
return @communicator.post(
uri,
client_headers,
nil,
nil,
Ingenico::Connect::SDK::Domain::Dispute::DisputeResponse,
context)
rescue ResponseException => e
error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
error_object = @communicator.marshaller.unmarshal(e.body, error_type)
raise create_exception(e.status_code, e.body, error_object, context)
end
# Resource /!{merchantId}/disputes/!{disputeId} - {https://epayments-api.developer-ingenico.com/fileserviceapi/v1/en_US/ruby/disputes/uploadFile.html Upload File}
# @param dispute_id [String]
# @param body [Ingenico::Connect::SDK::Merchant::Disputes::UploadFileRequest]
# @param context [Ingenico::Connect::SDK::CallContext]
# @return [Ingenico::Connect::SDK::Domain::Dispute::UploadDisputeFileResponse]
# @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
# @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
# @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
# @raise [Ingenico::Connect::SDK::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
# or there was a conflict (HTTP status code 404, 409 or 410)
# @raise [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
# the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer,
# or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
# @raise [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
def upload_file(dispute_id, body, context=nil)
path_context = {
'disputeId'.freeze => dispute_id,
}
uri = instantiate_uri('/files/v1/{merchantId}/disputes/{disputeId}', path_context)
return @communicator.post(
uri,
client_headers,
nil,
body,
Ingenico::Connect::SDK::Domain::Dispute::UploadDisputeFileResponse,
context)
rescue ResponseException => e
error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
error_object = @communicator.marshaller.unmarshal(e.body, error_type)
raise create_exception(e.status_code, e.body, error_object, context)
end
end
end
end
end