Sample Service Manual

This section covers the sample service and web the methods used for sample scenarios.

You can also use the PDF manual found here.

Common documentation covering architecture, security, error handling etc is found in the common implementations manual.

Prerequisites

Before you start intregrating a system with PayEx Connect please make sure that:

  • You have basic knowledge of Web Services, including WSDL, Soap and WS-Security.
  • You understand that PayEx Connect is designed to simplify integration for clients using Microsoft .Net, Java Axis or other frameworks that have built-in support for WS-Security and other W3C standars.

Service Overview - SampleService

The sample service exposes web methods used for sample scenarios. Access to this service requires explicit permissions on company number level.

The complete Wsdl specification for this service can be found at:
https://connect.payex.com/SampleService.asmx?wsdl.

Data types sample

The web method SampleMethod demonstrates the different string formats supported by PayEx Connect.

Session state sample

The web methods InitializeSessionState and UpdateSessionState demonstrates the per-user session state management used in some parts of PayEx Connect. Methods requiring per-user session management has the following text in the Remarks section:

This method utilizes optimistic versioning concurrency control to ensure object consistency. This requires per-user session management by the service consumer. Details about versioning and session support can be found in the common documentation.

Web methods

SampleMethod

Sample method that returns a string containing the input string, an amount, a date and a datetime. Demonstrates the basic concepts of PayEx Connect and the ideal method to use when beginning a PayEx Connect integration.

Class diagram

1-class-diagram.png

Request parameters

SampleMethodRequestType
FieldDatatypeRequiredMax lengthDescription
SampleTextStringYes16The input text to be returned as part of the return value. Throws SOAP fault error code 3010 if max text length of 16 characters is exceeded.

Response parameters

sampleMethodResponsetype
FieldDatatypeDescription
SampleTextStringThe input as a value
SampleAmountStringA string representing a sample amount
SampleDateStringA string representing a sample date
SampleDateTimeStringA string representing a sample date and time

Exceptions

Specific exceptions for this method.

detail.ErrorCodeSOAP faultCodeDescription
3010Client.3010Request invalid. Invalid or missing sample text.

InitializeSessionValue

This method is part of the sample demonstrating session state across multiple requests. Use this method to initialize the numeric value managed through server state. Use the UpdateSessionState method to update the value.

Class diagram

2-class-diagram.png

Request parameters

InitializeSessionValueRequestType
FieldDatatypeRequiredDescription
InitialValueIntegerYesInitial numeric value. Possible values are 0 to 1000.

Response parameters

InitializeSessionValueResponseType
FieldDatatypeDescription
CurrentValueIntegerCurrent numeric value managed through server state.

Remarks

This method utilizes optimistic versioning concurrency control to ensure object consistency. This requires per-user session management by the service consumer.

UpdateSessionValue

This method is part of the sample demonstrating session state across multiple requests. Use this method to add a value to the numeric value managed through server state. Use the InitializeSessionState method to initiate the value before calling UpdateSessionState.

Class diagram

3-class-diagram.png

Request parameters

UpdateSessionValueRequestType
FieldDatatypeRequiredDescription
AddedlValueIntegerYesValue to add. Possible values are 0 to 1000.

Response parameters

UpdateSessionValueResponseType
FieldDatatypeDescription
CurrentValueIntegerCurrent numeric value managed through server state.

Exceptions

Specific exceptions for this method.

detail.ErrorCodeSOAP faultCodeDescription
4001Client.4001Concurrency control failure. Item not loaded into session state. InitializeSessionValue must be invoked before UppdateSessionValue

Remarks

This method utilizes optimistic versioning concurrency control to ensure object consistency. This requires per-user session management by the service consumer.

 

Created by David Persson on 2020/01/21 09:34