addToFraudList

To search in the page use Ctrl+F on your keyboard

The operation allows the management of the list types by insertion of PAN, TOKEN, Tid /Date, Tref.

Recommended interfaceVersion: WR_WS_2.55

Endpoints

json
soap

PROD

https://office-server.mercanet.com/rs-services/v2/fraud/addToFraudList

method

POST
TEST

https://office-server-mercanet.test.sips-services.com/rs-services/v2/fraud/addToFraudList

method

POST

PROD

https://office-server.mercanet.com/services/v2/fraud?wsdl

method

POST
TEST

https://office-server-mercanet.test.sips-services.com/services/v2/fraud?wsdl

method

POST

Request

Required

fraudListElementValue

presence

Required

Interface version

2.15

Format

ANS128

Depending on the fraudListElementType, this field refers to the fraud list used. Below two examples of use cases:fraudListElementType = PAN fraudListElementValue contains a list of card numbers. fraudListElementType = TRANSACTION_ID fraudListElementValue contains a list of pairs (transactionId – transactionDate) in the following form: transactionId”@”transactionDate (example: 123987@20180919).
fraudListLevel

presence

Required

Interface version

2.15

Format

ANS20(restricted values)

Level / Color of the fraud list to be fed.

List of values

Black

Black list

Grey

Grey list

White

White list
fraudListType

presence

Required

Interface version

2.15

Format

ANS20(restricted values)

Type of list used for the Fraud check.

List of values

BicList

Bic List

CardBinList

Card Bin list

CardList

Card list

CustomerNameList

Customer name list

EmailList

Email list

IbanList

IBAN list

IdList

ID List

IpList

IP Address List

MandateList

Mandate List

PhoneNumberList

Phone number list

PostalCodeList

Postal code list
interfaceVersion
presence

Required

Interface version

2.15
Format
AN20(restricted String)
Version of the interface used. It is composed of a prefix that varies according to the function used and a version number (e.g. IR_WS_2.47).

Please refer to the function page for the value to use. Use the latest interface version number.

List of values

FR_WS_2.

Office (M2M) (SOAP) interface for Fraud functions.
keyVersion

presence

Required

Interface version

2.15

Format

N10

Version of the merchant’s secret key used to calculate the imprint of the message (key stored by the merchant to verify the imprint of the automatic and manual notifications).
merchantId

presence

Required

Interface version

2.15

Format

N15

Identifier of the shop, this value is provided to the merchant by Mercanet during the shop registration.
seal

presence

Required

Interface version

2.15

Format

ANS128

Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Conditional

fraudListElementType

presence

Conditional

Interface version

2.15

Format

ANS20(restricted values)

Feeding mode of the fraud card list.

List of values

PAN

Fraud list is populated with PAN of card

TOKEN

Fraud list is populated with Token of card

TRANSACTION_ID

Fraud list is populated with transaction identifier (transactionId, transactionDate)

TRANSACTION_REF

Fraud list is populated with transaction reference (transactionReference)

Optional

fraudListReasonCode

presence

Optional

Interface version

2.15

Format

AN3(restricted values)

The code of the reason why the element is added in the fraud list.

List of values

b2bCustomer

B2B Customer

bin_rangeTrusted

Bin range Trusted

cardForbidden

Card Forbidden

cardHolderReject

Cardholder Reject

cardLost

Card Lost

cardStolen

Card Stolen

cardUnknown

card Unknown

customerTrusted

Customer Trusted

debitNotPossible

Debit Not Possible

duplicatePaymentAttempt

Duplicate Payment Attempt

emailTrusted

Email Trusted

emailUnknown

Email Unknown

externallyBlackListed

Externally Black Listed

fraudSuspicion

Fraud Suspicion

fromMdiFiles

From Mdi Files

generalSuspicion

General Suspicion

ibanTrusted

Iban Trusted

ipTrusted

IP Trusted

ipUnknown

IP Unknown

mandateTrusted

Mandate trusted

nameTrusted

Name Trusted

negativeExperience

Negative Experience

notSpecified

Not Specified

panTrusted

Pan Trusted

phoneTrusted

Phone Trusted

phoneUnknown

Phone Unknown

positiveExperience

Positive experience

specialAction

Special Action

travelCards

Travel Cards

unpaid

Unpaid

vip

VIP

zipUnknown

Zip Unknown
intermediateServiceProviderId

presence

Optional

Interface version

2.15

Format

AN30

Identifier of the Service used by the merchant for the exchanges with the Mercanet platform.
sealAlgorithm

presence

Optional

Interface version

2.15

Format

ANS20(restricted values)

Algorithm applied to calculate the seal encryption.

List of values

HMAC-SHA-256

The encryption algorithm applied is HMAC-SHA-256

HMAC-SHA-512

The encryption algorithm applied is HMAC-SHA-512

SHA-256

The encryption algorithm applied is SHA-256

            {
  "fraudListElementType": "PAN",
  "fraudListElementValue": "5017674000000200",
  "fraudListLevel": "WHITE",
  "fraudListType": "CARD_LIST",
  "interfaceVersion": "FR_WS_2.15",
  "keyVersion": "1",
  "merchantId": "226000009630001",
  "seal": "b3f44355e912ebb9c3fed0e3a00a5782762afd604055f3a56438971a4e9ec58f"
}

                  <urn:addToFraudList>
            <urn:merchantId>226000009630001</urn:merchantId>
            <urn:interfaceVersion>FR_WS_2.15</urn:interfaceVersion>
            <urn:fraudListType>CARD_LIST</urn:fraudListType>
            <urn:fraudListLevel>WHITE</urn:fraudListLevel>
            <urn:fraudListElementType>WHITE</urn:fraudListElementType >
            <urn:fraudListElementValue>5017674000000200</urn:fraudListElementValue>
            <urn:secretKey>EqoB2nuLFmbz79YQ0G1JGlxKoNzCx9objHYb49GGp_A</urn:secretKey>
            <urn:keyVersion>1</urn:keyVersion>
      </urn:addToFraudList >

Response

Required

seal

presence

Required

Interface version

2.15

Format

ANS128

Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Optional

errorFieldName

presence

Optional

Interface version

2.15

Format

ANS50

Error field name of the incoming request. Present when responseCode = 12 or 30.
fraudResponseCode

presence

Optional

Interface version

2.15

Format

N2

Fraud response code.

Response sample

json
soap

            {
  "fraudResponseCode": "00",
  "seal": "0a7c1ab8fa767313e0631d166843eb55b9f783426241690a2b6e23ca40087811"
}

                  <addToFraudListResponse xmlns="urn:sips:cn:contract:office:diagnostic:v2">
         <output>
            <responseCode>00</responseCode>
            <seal>0cecd48cf50085be7bbf24d6929b13115323639724f58d5aea1350cc670f14e1</seal>
         </output>
      </addToFraudListResponse>

Changelog

Filter

Interface version	Data	Attendance
2.15	`fraudListReasonCode`	Request
2.15	`intermediateServiceProviderId`	Request
2.15	`sealAlgorithm`	Request
2.15	`fraudListElementValue`	Request
2.15	`fraudListLevel`	Request
2.15	`fraudListType`	Request
2.15	`interfaceVersion`	Request
2.15	`keyVersion`	Request
2.15	`merchantId`	Request
2.15	`seal`	Request/Response
2.15	`fraudListElementType`	Request
2.15	`errorFieldName`	Response
2.15	`fraudResponseCode`	Response

addToFraudList

Endpoints

Request

Required

`fraudListElementValue`

`fraudListLevel`

`fraudListType`

`interfaceVersion`

`keyVersion`

`merchantId`

`seal`

Conditional

`fraudListElementType`

Optional

`fraudListReasonCode`

`intermediateServiceProviderId`

`sealAlgorithm`

Request sample

Response

Required

`seal`

Optional

`errorFieldName`

`fraudResponseCode`

Response sample

Changelog

Need help?