addToFraudList

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Cette opération permet d’ajouter un numéro de carte, de token ou de transaction (via le couple transactionIid/transactionDate ou transactionReference) à différents types de liste fraude.

interfaceVersion recommandée : FR_WS_2.53

PROD

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

méthode

POST
TEST

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

méthode

POST

PROD

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

méthode

POST
TEST

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

méthode

POST

Requête

Obligatoire

fraudListElementValue

présence

Obligatoire

Interface version

2.15

Format

ANS128

En fonction du fraudListElementType, ce champ désigne la liste fraude utilisée.Ci-après deux exemples de cas d’usage. fraudListElementType = PAN :fraudListElementValue contient une liste de numéros de carte. fraudListElementType = TRANSACTION_ID : fraudListElementValue contient une liste de couple transactionId - transactionDate sous la forme transactionId”@”transactionDate (exemple : 123987@20180919).
fraudListLevel

présence

Obligatoire

Interface version

2.15

Format

ANS20(restricted values)

Niveau / Couleur de la liste de fraude à alimenter.

Liste des valeurs

Black

Liste noire

Grey

Liste grise

White

Liste blanche
fraudListType

présence

Obligatoire

Interface version

2.15

Format

ANS20(restricted values)

Code réponse de la fraude.

Liste des valeurs

BicList

Liste de Bic

CardBinList

Liste de Bin de carte

CardList

Liste de carte

CustomerNameList

Liste de nom d’acheteur

EmailList

Liste d’email

IbanList

Liste d’IBAN

IdList

Liste d’ID

IpList

Liste d’adresse IP

MandateList

Liste de mandats

PhoneNumberList

Liste de numéro de telephone

PostalCodeList

Liste de code postal
interfaceVersion
présence

Obligatoire

Interface version

2.15
Format
AN20(restricted String)
Version de l’interface utilisée. Elle est composée d’un préfixe qui varie selon la fonction utilisée et d’un numéro de version (ex : IR_WS_2.47).

Veuillez-vous référer à la page de la fonction pour connaître la valeur à utiliser. Utilisez le dernier numéro d’interfaceVersion.

Liste des valeurs

FR_WS_2.

interface Sogenactif Office Serveur (SOAP) interface pour les fonctions de fraude.
keyVersion

présence

Obligatoire

Interface version

2.15

Format

N10

Version de la clé secrète du commerçant utilisée pour calculer l’empreinte du message (clé stockée par le commerçant pour vérifier l’empreinte des notifications automatiques et manuelles).
merchantId

présence

Obligatoire

Interface version

2.15

Format

N15

Identifiant de la boutique, sa valeur est fournie par Sogenactif au commerçant lors de l’inscription de sa boutique.
seal

présence

Obligatoire

Interface version

2.15

Format

ANS128

Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).

Conditionnel

fraudListElementType

présence

Conditionnel

Interface version

2.15

Format

ANS20(restricted values)

Mode d’alimentation de la liste de type carte.

Liste des valeurs

PAN

Alimentation de la liste de carte en Fraude avec le PAN

TOKEN

Alimentation de la liste de carte en Fraude avec le Token

TRANSACTION_ID

Alimentation de la liste de carte en Fraude avec l’identifiant de la transaction (transactionId, transactionDate)

TRANSACTION_REF

Alimentation de la liste de carte en Fraude avec la référence de la transaction (transactionReference)

Optionnel

fraudListReasonCode

présence

Optionnel

Interface version

2.15

Format

AN3(restricted values)

Raison pour laquelle l’élément est ajouté dans la liste de la fraude.

Liste des valeurs

b2bCustomer

Acheteur B2B

bin_rangeTrusted

Série de carte de confiance

cardForbidden

Carte interdite

cardHolderReject

Rejet du porteur de carte

cardLost

Carte perdue

cardStolen

Carte volée

cardUnknown

Carte inconnue

customerTrusted

Acheteur de confiance

debitNotPossible

Débit impossible

duplicatePaymentAttempt

Tentative de paiement en double

emailTrusted

Email de confiance

emailUnknown

Email inconnu

externallyBlackListed

Présent dans liste noire externe

fraudSuspicion

Suspicion de fraude

fromMdiFiles

Issu de fichiers Mdi

generalSuspicion

Générale suspicion

ibanTrusted

IBAN de confiance

ipTrusted

Adresse IP de confiance

ipUnknown

Adresse IP inconnue

mandateTrusted

Mandat de confiance

nameTrusted

Nom de confiance

negativeExperience

Expérience négative

notSpecified

Non spécifié

panTrusted

PAN de confiance

phoneTrusted

Téléphone de confiance

phoneUnknown

Téléphone inconnu

positiveExperience

Expérience positive

specialAction

action spéciale

travelCards

Cartes de voyage

unpaid

Impayé

vip

VIP

zipUnknown

Zip inconnu
intermediateServiceProviderId

présence

Optionnel

Interface version

2.15

Format

AN30

Identifiant du service utilisé par le commerçant pour les échanges de flux avec la plateforme Sogenactif.
sealAlgorithm

présence

Optionnel

Interface version

2.15

Format

ANS20(restricted values)

Algorithme de cryptage utilisé pour le calcul du sceau.

Liste des valeurs

HMAC-SHA-256

L’algorithme de cryptage utilisé est HMAC-SHA-256

HMAC-SHA-512

L’algorithme de cryptage utilisé est HMAC-SHA-512

SHA-256

L’algorithme de cryptage utilisé est SHA-256

Exemple de requête

json
soap

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

Réponse

Obligatoire

seal

présence

Obligatoire

Interface version

2.15

Format

ANS128

Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).

Optionnel

errorFieldName

présence

Optionnel

Interface version

2.15

Format

ANS50

Nom du champ en erreur dans la requête. Présent lorsque responseCode = 12 ou 30.
fraudResponseCode

présence

Optionnel

Interface version

2.15

Format

N2

Code réponse du serveur Sogenactif pour l’alimentation de la liste de fraude.

Exemple de réponse

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

Filtre

Interface version	Donnée	Présence
2.15	`fraudListReasonCode`	Requête
2.15	`intermediateServiceProviderId`	Requête
2.15	`sealAlgorithm`	Requête
2.15	`fraudListElementValue`	Requête
2.15	`fraudListLevel`	Requête
2.15	`fraudListType`	Requête
2.15	`interfaceVersion`	Requête
2.15	`keyVersion`	Requête
2.15	`merchantId`	Requête
2.15	`seal`	Requête/Réponse
2.15	`fraudListElementType`	Requête
2.15	`errorFieldName`	Réponse
2.15	`fraudResponseCode`	Réponse

addToFraudList

Urls des environnements

Requête

Obligatoire

`fraudListElementValue`

`fraudListLevel`

`fraudListType`

`interfaceVersion`

`keyVersion`

`merchantId`

`seal`

Conditionnel

`fraudListElementType`

Optionnel

`fraudListReasonCode`

`intermediateServiceProviderId`

`sealAlgorithm`

Exemple de requête

Réponse

Obligatoire

`seal`

Optionnel

`errorFieldName`

`fraudResponseCode`

Exemple de réponse

Changelog

Besoin d'aide ?