15 minutes to read

🛈 Important

This topic applies only to Worldpay UK

This section guides you through the discrete implementation steps in order to complete a successful implementation.

Specification

Review the specification for the MAX Pay Global payment connector to ensure it meets your requirements, prior to deployment.

Retail Realm prerequisites

  1. MAX Pay Global for Dynamics 365 Finance / Commerce LCS packages.
  2. MAX Pay Global test / production licenses.

Prerequisite tasks and information required

You will require the following prerequisite pieces of information and tasks to be completed prior to implementing MAX Pay Global:


Item

Task/Description

Required

From

Sample value

IPC 2.3.1

Install and correctly pre-configure the IPC on the designated Windows PC where the Hardware station (Local or Shared) will reside.

Yes

Worldpay UK


Payment device

You will require a Payment device that is supported with the IPC software.

Contact WorldpayUK.

Yes

Worldpay UK


Test cards

Ensure you have WorldpayUK specific test cards to use during your test phase

Yes

Worldpay UK


IPC IP address

The IP Address of the IPC.  Normally the IPC is installed on the same Windows PC as the POS and the ip address would be the loopback address.  Where the IPC is installed on a shared hardware station or centralized deployment model, you would need the ip address of that machine/IPC instance.  

You will need this during the Hardware profile/ Register (Terminal parameter) configuration.

Yes

Worldpay UK

127.0.0.1

IPC port

The IPC is normally configured to use the interfacing socket and the IPC assigns a port for this, to allow MAX Pay Global to communicate to it.

You will need this during the Hardware profile / Register (Terminal parameter) configuration.

Yes

Worldpay UK

10000

Merchant code

Omni channel scenarios: For each entity (e.g. Store), you will require the Merchant code.  This is used within the various profiles and determines which Merchant account funds are deposited to.  

Omni channel scenarios not supported: Merchant code is not required for simple cash and carry transactions.

Yes

Worldpay UK

RetailComp

Service API url

Omni channel scenarios: you will require service API url.

Test: https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp

Production: https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp

Omni channel scenarios not supported: Service API url is not required for simple cash and carry transactions.

Yes

Worldpay UK


User name

Omni channel scenarios: You will require a user name that is associated with the above Merchant code.

Omni channel scenarios not supported: user name is not required for simple cash and carry transactions.

Yes

Worldpay UK


Password

Omni channel scenarios: You will require a password that is associated with the above Merchant code.

Omni channel scenarios not supported: Password is not required for simple cash and carry transactions.




Installation id

Omni channel scenarios: You will require an installation id that is associated with the above Merchant code.

Omni channel scenarios not supported: Installation id is not required for simple cash and carry transactions.

Yes

Worldpay UK








Installation steps

This section describes the specific installation steps


#

Item

Required

Navigation

Notes

1

Obtain the deployable packages from Retail Realm

Yes

Request these from your Retail Realm project manager


2

Deploy the packages to your environment using LCS

Yes

Package deployment


3

Configure Retail scheduler

Yes

Initializing the retail scheduler


4

Configure Shared parameters (Common)

Yes

Configuring shared parameters


5

Configure the shared parameters for your chosen payment provider

Yes

Configure options for WorldpayUK

Only carry out this if you need to specify credit card note while creating card token at Point of sale

6

Configure Payment services

Yes

Payment services


7

Configure Retail POS

Optional

Hardware profile

Only carry out this if you are using Commerce and using the Point of sale

8

Configure Call center

Optional

Payment services

Only carry this out if you are using Call enter

9

Configure Online store

Optional

Online store

Only carry this out if you are using Microsoft e-Commerce Store Front

10

Apply license(s)

Yes


Applying the licensing is required prior to performing a payment transaction but not required to install and configure

11

Perform a test transaction

Yes


Once you have completed your configuration, perform a test transaction


Next topic