logo Mercanet

Release 24.5

go directly to content

Search by keywords

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

  • 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

Required

Conditional

Optional

  • fraudListReasonCode
    presence
    Optional
    Interface version
    2.15

    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

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

  • sealAlgorithm
    presence
    Optional
    Interface version
    2.15

    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

Request sample

            {
  "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 >

        

Required

  • seal
    presence
    Required
    Interface version
    2.15

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

Optional

Response sample

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

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

        

Changelog


Interface version Data Attendance Container
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