Interface IConnection

Represents a connection to the Ingenico ePayments platform server. Thread-safe.

Inherited Members

IDisposable.Dispose()

ILoggingCapable.EnableLogging(ICommunicatorLogger)

ILoggingCapable.DisableLogging()

Namespace: Ingenico.Connect.Sdk

Assembly: connect-sdk-dotnet.dll

Syntax

public interface IConnection : IDisposable, ILoggingCapable

Methods

Delete<R>(Uri, IEnumerable<IRequestHeader>, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>)

Send a DELETE request to the Ingenico ePayments platform.

Declaration

Task<R> Delete<R>(Uri uri, IEnumerable<IRequestHeader> requestHeaders, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R> responseHandler)

Parameters

Type	Name	Description
Uri	uri	The URI to call, including any necessary query parameters.
IEnumerable<IRequestHeader>	requestHeaders	An optional list of request headers.
Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>	responseHandler	A callback that handles the stream from the response

Returns

Type	Description
Task<R>	Returns the object that was returned from the callback

Type Parameters

Name	Description
R

Exceptions

Type	Condition
CommunicationException	when an exception occurred communicating with the Ingenico ePayments platform

Get<R>(Uri, IEnumerable<IRequestHeader>, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>)

Send a GET request to the Ingenico ePayments platform.

Declaration

Task<R> Get<R>(Uri uri, IEnumerable<IRequestHeader> requestHeaders, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R> responseHandler)

Parameters

Type	Name	Description
Uri	uri	The URI to call, including any necessary query parameters.
IEnumerable<IRequestHeader>	requestHeaders	An optional list of request headers.
Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>	responseHandler	A callback that handles the stream from the response

Returns

Type	Description
Task<R>	Returns the object that was returned from the callback

Type Parameters

Name	Description
R

Exceptions

Type	Condition
CommunicationException	when an exception occurred communicating with the Ingenico ePayments platform

Post<R>(Uri, IEnumerable<IRequestHeader>, MultipartFormDataObject, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>)

Send a multipart/form-data POST request to the Ingenico ePayments platform.

The content type of the request will be be part of the given request header list. If the connection creates its own content type, it should be multipart.getContentType(). Otherwise, authentication failures will occur.

Declaration

Task<R> Post<R>(Uri uri, IEnumerable<IRequestHeader> requestHeaders, MultipartFormDataObject multipart, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R> responseHandler)

Parameters

Type	Name	Description
Uri	uri	The URI to call, including any necessary query parameters.
IEnumerable<IRequestHeader>	requestHeaders	An optional list of request headers.
MultipartFormDataObject	multipart	The multipart/form-data request to send.
Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>	responseHandler	A callback that handles the stream from the response

Returns

Type	Description
Task<R>	Returns the object that was returned from the callback

Type Parameters

Name	Description
R

Exceptions

Type	Condition
CommunicationException	when an exception occurred communicating with the Ingenico ePayments platform

Post<R>(Uri, IEnumerable<IRequestHeader>, string, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>)

Send a POST request to the Ingenico ePayments platform.

Declaration

Task<R> Post<R>(Uri uri, IEnumerable<IRequestHeader> requestHeaders, string body, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R> responseHandler)

Parameters

Type	Name	Description
Uri	uri	The URI to call, including any necessary query parameters.
IEnumerable<IRequestHeader>	requestHeaders	An optional list of request headers.
string	body	The optional body to send.
Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>	responseHandler	A callback that handles the stream from the response

Returns

Type	Description
Task<R>	Returns the object that was returned from the callback

Type Parameters

Name	Description
R

Exceptions

Type	Condition
CommunicationException	when an exception occurred communicating with the Ingenico ePayments platform

Put<R>(Uri, IEnumerable<IRequestHeader>, MultipartFormDataObject, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>)

Send a multipart/form-data PUT request to the Ingenico ePayments platform.

The content type of the request will be be part of the given request header list. If the connection creates its own content type, it should be multipart.getContentType(). Otherwise, authentication failures will occur.

Declaration

Task<R> Put<R>(Uri uri, IEnumerable<IRequestHeader> requestHeaders, MultipartFormDataObject multipart, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R> responseHandler)

Parameters

Type	Name	Description
Uri	uri	The URI to call, including any necessary query parameters.
IEnumerable<IRequestHeader>	requestHeaders	An optional list of request headers.
MultipartFormDataObject	multipart	The multipart/form-data request to send.
Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>	responseHandler	A callback that handles the stream from the response

Returns

Type	Description
Task<R>	Returns the object that was returned from the callback

Type Parameters

Name	Description
R

Exceptions

Type	Condition
CommunicationException	when an exception occurred communicating with the Ingenico ePayments platform

Put<R>(Uri, IEnumerable<IRequestHeader>, string, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>)

Send a PUT request to the Ingenico ePayments platform.

Declaration

Task<R> Put<R>(Uri uri, IEnumerable<IRequestHeader> requestHeaders, string body, Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R> responseHandler)

Parameters

Type	Name	Description
Uri	uri	The URI to call, including any necessary query parameters.
IEnumerable<IRequestHeader>	requestHeaders	An optional list of request headers.
string	body	The optional body to send.
Func<HttpStatusCode, Stream, IEnumerable<IResponseHeader>, R>	responseHandler	A callback that handles the stream from the response

Returns

Type	Description
Task<R>	Returns the object that was returned from the callback

Type Parameters

Name	Description
R

Exceptions

Type	Condition
CommunicationException	when an exception occurred communicating with the Ingenico ePayments platform