PM Query

Contents

1. Introduction

PM Query is a feature that allows a merchant to retrieve the payment conditions for a specific Payment Method (e.g. expenses, rate, amounts and dates of upcoming payments, etc.) prior to the payment, in order to show this information to the customer before he confirms his order.

2. Implementation

The information is gathered via an https request to the following page, using a form containing input parameters: https://mdepayments.epdq.co.uk/ncol/test/queryPM.asp

Note: Replace 'test' by 'prod' when you want to switch from test to our production environment.

2.1 Input Parameters

Name

Mandatory

Description

USERID

Y

User ID used to perform the query.

REFID

N

Only if PSPID is part of a group

REFKIND

N

If using REFID, specify the type: PSPID, MGID, (none)

PSWD

Y

User or PSPID Password

PSPID

Y

Unique identifier on our system

ORDERID

Y

Merchant's unique order reference

AMOUNT

Y

Amount of the transaction x100

CURRENCY

Y

ISO 3-letter code (EUR, USD, CHF, etc.)

LANGUAGE

Y

2-digit language code (fr, en, etc.)

PM

Y

Payment method ('3XCB')

OPERATION

Y

"VEN" or "RES" according to PM configuration

CIVILITY

Y

Civility of the buyer (Mr, Mme, etc.)

ECOM_BILLTO_POSTAL_NAME_FIRST

Y

Customer's first name

ECOM_BILLTO_POSTAL_NAME_LAST

Y

Customer's last name

SHASIGN

Y

SHA Signature (see next chapter)

WITHROOT

N

defines whether the XML response should be encapsulated in one global root element

More information about these fields can be found in your account. Just log in and go to: "Support > Integration & user manuals > Technical guides > Parameter Cookbook".

In order to verify the integrity of the submitted data, our system requires each request to include a SHA signature. This signature is built by hashing the contents of the request, in the 'parameter=value' format in alphabetical order.

Contrary to the input parameters, the amounts in the response have a decimal separator

Date formats are dd/MM/yyyy

We strongly advise you to verify the data by performing a SHA-OUT check on the returned data.

In order to verify the integrity of the submitted data, our system requires each request to include a SHA signature. This signature is built by hashing the contents of the request, in the 'parameter=value' format in alphabetical order.