Interface POST

De Documentation Mercanet
Aller à : navigation, rechercher

Sommaire

Demande de paiement

Champs génériques

Nom du champ

Présence

Dans la version

Commentaires

amount

Obligatoire

HP_1.0

automaticResponseUrl

Optionnel

HP_1.0

billingFirstDate

Optionnel

HP_2.5

bypassDcc

Optionnel

HP_2.11

captureDay

Optionnel

HP_1.0

captureMode

Optionnel

HP_1.0

currencyCode

Obligatoire

HP_1.0

customer3DSTransactionDate

Optionnel

HP_2.5

customerBillingNb

Optionnel

HP_2.5

customerDeliverySuccessFlag

Optionnel

HP_2.5

customerId

Optionnel

HP_2.0

customerIpAddress

Optionnel

HP_2.1

customerLanguage

Optionnel

HP_1.0

customerPhoneValidationMethod

Optionnel

HP_2.5

customerRegistrationDateOnline

Optionnel

HP_2.5

customerRegistrationDateProxi

Optionnel

HP_2.5

deliveryFirstDate

Optionnel

HP_2.5

evidenceAcquisitionDate

Optionnel

HP_2.5

evidenceNumber

Optionnel

HP_2.5

evidenceType

Optionnel

HP_2.5

expirationDate

Optionnel

HP_1.0

hashAlgorithm1

Optionnel

HP_2.3

hashAlgorithm2

Optionnel

HP_2.3

hashSalt1

Optionnel

HP_2.1

hashSalt2

Optionnel

HP_2.1

holderAdditionalReference

Optionnel

HP_2.9

intermediateServiceProviderId

Optional

HP_2.12

invoiceReference

Optionnel

HP_2.0

keyVersion

Obligatoire

HP_1.0

mandateId

Optionnel

HP_2.5

merchantId

Obligatoire

HP_1.0

merchantSessionId

Optionnel

HP_2.0

merchantTransactionDateTime

Optionnel

HP_2.0

merchantWalletID

Optionnel

HP_2.2

normalReturnUrl

Obligatoire

HP_1.0

orderChannel

Optionnel

HP_2.1

orderId

Optionnel

HP_1.0

paymentMeanBrandList

Optionnel

HP_1.0

paymentPattern

Optionnel

HP_2.1

Ce champ est obligatoire pour certain moyens de paiement. Se référer au guide d’implémentation du moyen de paiement concerné pour plus de détail.

returnContext

Optionnel

HP_2.0

riskManagementCustomDataList

Optionnel

HP_2.9

Une liste d’objet riskManagementCustomData

statementReference

Optionnel

HP_2.3

subMerchantCategoryCode

Optionnel

HP_2.15

subMerchantId

Optionnel

HP_2.15

subMerchantLegalId

Optionnel

HP_2.15

subMerchantShortName

Optionnel

HP_2.15

templateName

Optionnel

HP_2.1

transactionActors

Optionnel

HP_2.2

transactionOrigin

Optionnel

HP_2.0

transactionReference

Optionnel

HP_1.0

valueDate

Optionnel

HP_2.5

Tableau 2: requête de paiement

Champs optionnels relatifs à la fraude

Données d’entrée fraudData

Champ

Présence

Dans la version

Commentaires

allowedCardArea

Optionnel

HP_2.1

allowedCardCountryList

Optionnel

HP_2.1

allowedIpArea

Optionnel

HP_2.1

allowedIpCountryList

Optionnel

HP_2.1

bypass3DS

Optionnel

HP_2.1

bypassCtrlList

Optionnel

HP_2.1

bypassInfoList

Optionnel

HP_2.1

deniedCardArea

Optionnel

HP_2.1

deniedCardCountryList

Optionnel

HP_2.1

deniedIpArea

Optionnel

HP_2.1

deniedIpCountryList

Optionnel

HP_2.1

riskManagementDynamicSettingList

Optionnel

HP_2.10

Une liste d’objet riskManagementDynamicSetting

Tableau 3: Détails des champs relatifs à la fraude

Données d’entrée riskManagementDynamicSetting

Champ

Présence

As of version

Comments

riskManagementDynamicParam

Obligatoire

HP_2.10

riskManagementDynamicValue

Obligatoire

HP_2.10

Table 4: Détails des champs RiskManagementDynamicSetting

Champs optionnels relatifs aux pages de paiement

Données d’entrée paypageData

Champ

Présence

Dans la version

Commentaires

bypassReceiptPage

Optionnel

HP_2.0

Tableau 5: Détails des champs concernant le fonctionnement des pages de paiement

Champs optionnels relatifs à L’authentification

Données d’entrée authenticationData

Données d’entrée IssuerWalletPolicy

Champ

Presence

Dans la version

Commentaires

check3DS

Optionnel

HP_2.2

checkCSC

Optionnel

HP_2.2

Tableau 6: Détails des champs concernant l’authentification par Wallet

Données d’entrée CardAuthPolicy

Champ

Présence (M/O)

Dans la version

Commentaires

checkAVS

Optionnel

HP_2.8

ignoreAddressCheckResult

Optionnel

HP_2.8

ignorePostcodeCheckResult

Optionnel

HP_2.8

ignoreCSCCheckResult

Optionnel

HP_2.17

Tableau 7: Détails des champs concernant l’authentification par carte

Champs optionnels relatifs aux moyens de paiement

Données d’entrée paymentMeanData

Données d’entrée Paypal

Champ

Présence

Dans la version

Commentaires

addrOverride

Optionnel

HP_2.2

dupCustom

Optionnel

HP_2.2

dupDesc

Optionnel

HP_2.2

dupFlag

Optionnel

HP_2.2

dupType

Optionnel

HP_2.2

invoiceId

Optionnel

HP_2.2

landingPage

Optionnel

HP_2.2

mobile

Optionnel

HP_2.2

orderDescription

Optionnel

HP_2.16

Tableau 8: Champs relatifs à PayPal

Données d’entrée SDD

Champ

Présence

Dans la version

Commentaires

mandateAuthentMethod

Optionnel

HP_2.2

mandateCertificationType

Optionnel

HP_2.5

mandateUsage

Optionnel

HP_2.2

Tableau 9: Champs relatifs à SDD

Données d’entrée Cofinoga3xcb

Champ

Présence

Dans la version

Commentaires

creditIndicator

Optionnel

HP_2.4

Tableau 10: Champs relatifs à Cofinoga3xcb

Données d’entrée PassBe

Champ

Présence

Dans la version

Commentaires

settlementModeList

Optionnel

HP_2.5

Tableau 11: Champs relatifs à PassBe

Données d’entrée Accord

Champ

Présence

Dans la version

Commentaires

settlementMode

Optionnel

HP_2.6

Tableau 12: Champs relatifs à Accord

Données d’entrée Facilypay

Champ

Présence

Dans la version

Commentaires

depositRefundIndicator

Optionnel

HP_2.6

receiverType

Optionnel

HP_2.6

settlementMode

Optionnel

HP_2.6

settlementModeVersion

Optionnel

HP_2.6

Tableau 13: Champs relatifs à Facilypay

Données d’entrée CetelemNxcb

Champ

Présence

Dans la version

Commentaires

nxcbTransactionReference1

Optionnel

HP_2.9

nxcbTransactionReference2

Optionnel

HP_2.9

s10NxcbTransactionId1

Optionnel

HP_2.9

s10NxcbTransactionId2

Optionnel

HP_2.9

Tableau 14: Champs relatifs à CetelemNxcb

Données d’entrée Presto

Champ

Présence

Dans la version

Commentaires

financialProduct

Obligatoire

HP_2.10

Obligatoire uniquement pour une transaction presto

paymentMeanCustomerId

Obligatoire

HP_2.10

Obligatoire uniquement pour une transaction presto

prestoCardType

Optionnel

HP_2.10

Table 15: Champs relatifs à Presto

Données d’entrée Cofidis3x

Champ

Présence

Dans la version

Commentaires

preScoreValue

Optionnel

HP_2.11

cofidisDisplayCancelButton

Optionnel

HP_2.11

cofidisPrivateData

Optionnel

HP_2.11

Table 16: Champs relatifs à cofidis3x

Données d’entrée Cofidis4x

Champ

Présence

Dans la version

Commentaires

preScoreValue

Optionnel

HP_2.12

cofidisDisplayCancelButton

Optionnel

HP_2.12

cofidisPrivateData

Optionnel

HP_2.12

Table 17: Champs relatifs à cofidis4x

Données d’entrée UnEuroCom

Champ

Présence

Dans la version

Commentaires

preScoreValue

Optionnel

HP_2.11

cofidisPrivateData

Optionnel

HP_2.11

Table 18: Champs relatifs à unEuroCom

Données d’entrée Cofinoga

Champ

Présence

Dans la version

Commentaires

paymentMeanTradeOptionList

Optionnel

HP_2.15

Une liste d’objet paymentMeanTradeOption

Table 19: Champs relatifs à cofinoga

Données d’entrée paymentMeanTradeOption

Champ

Présence

Dans la version

Commentaires

paymentMeanTradingName

Optionnel

HP_2.15

settlementModeList

Optionnel

HP_2.15

Table 20: Champs relatifs à paymentMeanTradeOption

Données d’entrée Cetelem3x

Champ

Présence

Dans la version

Commentaires

cetelemPrivateMerchantData

Optionnel

HP_2.16

cetelemPrivateData

Optionnel

HP_2.16

Table 21: Champs relatifs à cetelem3x

Données d’entrée Cetelem4x

Champ

Présence

Dans la version

Commentaires

cetelemPrivateMerchantData

Optionnel

HP_2.16

cetelemPrivateData

Optionnel

HP_2.16

Table 22: Champs relatifs à cetelem4x

Champs optionnels relatifs au PAIEMENT échelonné

Données d’entrée instalmentData

Champ

Présence

Dans la version

Commentaires

number

Optionnel

HP_2.2

datesList

Optionnel

HP_2.2

transactionReferencesList

Optionnel

HP_2.2

s10TransactionIdsList

Optionnel

HP_2.7

amountsList

Optionnel

HP_2.2

Tableau 24 : Champs relatifs aux paiements récurrents

Champs optionnels pour les données de facturation

Données d’entrée billingAddress

Champ

Présence

Dans la version

Commentaires

addressAdditional1

Optionnel

HP_2.2

addressAdditional2

Optionnel

HP_2.2

addressAdditional3

Optionnel

HP_2.2

city

Optionnel

HP_2.2

company

Optionnel

HP_2.2

country

Optionnel

HP_2.2

postBox

Optionnel

HP_2.2

state

Optionnel

HP_2.2

street

Optionnel

HP_2.2

streetNumber

Optionnel

HP_2.2

zipCode

Optionnel

HP_2.2

Tableau 25: Champs prévus pour l’élément billingAddress

Données d’entrée billingContact

Champ

Présence

Dans la version

Commentaires

email

Optionnel

HP_2.2

firstname

Optionnel

HP_2.2

gender

Optionnel

HP_2.2

lastname

Optionnel

HP_2.2

mobile

Optionnel

HP_2.2

phone

Optionnel

HP_2.2

title

Optionnel

HP_2.2

Tableau 26: Champs prévus pour l’élément billingContact

Champs optionnels pour les données client

Données d’entrée customerAddress

Champ

Présence

Dans la version

Commentaires

addressAdditional1

Optionnel

HP_2.2

addressAdditional2

Optionnel

HP_2.2

addressAdditional3

Optionnel

HP_2.2

city

Optionnel

HP_2.2

company

Optionnel

HP_2.2

country

Optionnel

HP_2.2

postBox

Optionnel

HP_2.2

state

Optionnel

HP_2.2

street

Optionnel

HP_2.2

streetNumber

Optionnel

HP_2.2

zipCode

Optionnel

HP_2.2

businessName

Optionnel

HP_2.17

Tableau 27: Champs prévus pour l’élément customerAddress

Données d’entrée customerContact

Champ

Présence

Dans la version

Commentaires

email

Optionnel

HP_2.2

firstname

Optionnel

HP_2.2

gender

Optionnel

HP_2.2

lastname

Optionnel

HP_2.2

mobile

Optionnel

HP_2.2

phone

Optionnel

HP_2.2

title

Optionnel

HP_2.2

legalId

Optionnel

HP_2.17

positionOccupied

Optionnel

HP_2.17

Tableau 28: Champs prévus pour l’élément customerContact

Données d’entrée customerData

Champ

Présence

Dans la version

Commentaires

birthCity

Optionnel

HP_2.2

birthCountry

Optionnel

HP_2.2

birthDate

Optionnel

HP_2.2

birthZipCode

Optionnel

HP_2.2

nationalityCountry

Optionnel

HP_2.2

newPwd

Optionnel

HP_2.2

pwd

Optionnel

HP_2.2

maidenName

Optionnel

HP_2.18

Tableau 29: Champs prévus pour l’élément customerData

Champs optionnels pour les données de livraison

Données d’entrée deliveryAddress

Champ

Présence

Dans la version

Commentaires

addressAdditional1

Optionnel

HP_2.2

addressAdditional2

Optionnel

HP_2.2

addressAdditional3

Optionnel

HP_2.2

city

Optionnel

HP_2.2

company

Optionnel

HP_2.2

country

Optionnel

HP_2.2

postBox

Optionnel

HP_2.2

state

Optionnel

HP_2.2

street

Optionnel

HP_2.2

streetNumber

Optionnel

HP_2.2

zipCode

Optionnel

HP_2.2

Tableau 30: Champs prévus pour l’élément deliveryAddress

Données d’entrée deliveryContact

Champ

Présence

Dans la version

Commentaires

email

Optionnel

HP_2.2

firstname

Optionnel

HP_2.2

gender

Optionnel

HP_2.2

lastname

Optionnel

HP_2.2

mobile

Optionnel

HP_2.2

phone

Optionnel

HP_2.2

Title

Optionnel

HP_2.2

Tableau 31: Champs prévus pour l’élément deliveryContact

deliveryData inputs

Champ

Présence

Dans la version

Commentaires

deliveryChargeAmount

Optionnel

HP_2.6

deliveryMethod

Optionnel

HP_2.6

deliveryMode

Optionnel

HP_2.6

deliveryOperator

Optionnel

HP_2.6

estimatedDeliveryDate

Optionnel

HP_2.6

estimatedDeliveryDelay

Optionnel

HP_2.7

Table 32: Champs prévus pour l’élément deliveryData

Champs optionnels pour les données Du titulaire de carte

Données d’entrée holderAddress

Champ

Présence

Dans la version

Commentaires

addressAdditional1

Optionnel

HP_2.2

addressAdditional2

Optionnel

HP_2.2

addressAdditional3

Optionnel

HP_2.2

city

Optionnel

HP_2.2

company

Optionnel

HP_2.2

country

Optionnel

HP_2.2

postBox

Optionnel

HP_2.2

state

Optionnel

HP_2.2

street

Optionnel

HP_2.2

streetNumber

Optionnel

HP_2.2

zipCode

Optionnel

HP_2.2

Tableau 33: Champs prévus pour l’élément holderAddress

Données d’entrée holderContact

Champ

Présence

Dans la version

Commentaires

email

Optionnel

HP_2.2

firstname

Optionnel

HP_2.2

gender

Optionnel

HP_2.2

lastname

Optionnel

HP_2.2

mobile

Optionnel

HP_2.2

phone

Optionnel

HP_2.2

title

Optionnel

HP_2.2

Tableau 34: Champs prévus pour l’élément holderContact

Champs optionnels pour les données du panier

Données d’entrée shoppingCartDetail

Champ

Présence

Dans la version

Commentaires

mainProduct

Optionnel

HP_2.6

shoppingCartItemList

Optionnel

HP_2.6

Une liste de shoppingCartItem

shoppingCartTotalAmount

Optionnel

HP_2.6

shoppingCartTotalQuantity

Optionnel

HP_2.6

shoppingCartTotalTaxAmount

Optionnel

HP_2.7

Tableau 35: Champs prévus pour l’élément shoppingCartDetail

Données d’entrée shoppingCartItem

Champ

Présence

Dans la version

Commentaires

productCategory

Optionnel

HP_2.6

productCode

Optionnel

HP_2.6

productDescription

Optionnel

HP_2.6

productName

Optionnel

HP_2.6

productQuantity

Optionnel

HP_2.6

productSKU

Optionnel

HP_2.6

productTaxCategory

Optionnel

HP_2.11

productTaxRate

Optionnel

HP_2.6

productUnitAmount

Optionnel

HP_2.6

productUnitTaxAmount

Optionnel

HP_2.6

Tableau 36: Champs prévus pour l’élément shoppingCartItem

Champs optionnels pour les ID de Transaction Sips 1.0

Données d’entrée s10TransactionReference

Champ

Présence

Dans la version

Commentaires

s10TransactionId

Optionnel

HP_2.7

s10TransactionIdDate

Optionnel

HP_2.7

Tableau 37: Champs prévus pour l’élément s10TransactionReference

Champs optionnels pour les données de gestion du risque

Données d’entrée riskManagementCustomData

Champ

Présence

Dans la version

Commentaires

riskManagementCustomSequence

Optionnel

HP _2.9

riskManagementCustomValue

Optionnel

HP _2.9

Tableau 38: Champs prévus pour l’élément riskManagementCustomData

Champs optionnels pour les données du commercant

Données d’entrée subMerchantAddress

Champ

Présence

Dans la version

Commentaires

addressAdditional1

Optionnel

HP_2.15

addressAdditional2

Optionnel

HP_2.15

addressAdditional3

Optionnel

HP_2.15

city

Optionnel

HP_2.15

company

Optionnel

HP_2.15

country

Optionnel

HP_2.15

postBox

Optionnel

HP_2.15

state

Optionnel

HP_2.15

street

Optionnel

HP_2.15

streetNumber

Optionnel

HP_2.15

zipCode

Optionnel

HP_2.15

Tableau 39: Champs prévus pour l’élément subMerchantAddress

Champs optionnels pour AMEX-EA

Données d’entrée orderContext

Champ

Présence

Dans la version

Commentaires

customerHostName

Optionnel

HP_2.16

customerBrowserType

Optionnel

HP_2.16

customerANI

Optionnel

HP_2.16

customerANIInformationIdentifier

Optionnel

HP_2.16

TravelContext. departureDate

Optionnel

HP_2.16

TravelContext.passengerName

Optionnel

HP_2.16

TravelContext.originAirport

Optionnel

HP_2.16

TravelContext.numberOfRoutingCities

Optionnel

HP_2.16

TravelContext.routingCitiesList

Optionnel

HP_2.16

TravelContext.numberOfAirlineCarriers

Optionnel

HP_2.16

TravelContext.airlineCarriersList

Optionnel

HP_2.16

TravelContext.fareBasis

Optionnel

HP_2.16

TravelContext.numberOfPassengers

Optionnel

HP_2.16

TravelContext.destinationAirport

Optionnel

HP_2.16

TravelContext.reservationCode

Optionnel

HP_2.16

Table 23: Champs relatifs à orderContext

Données d’entrée travelContext

Champ

Présence

Dans la version

Commentaires

 departureDate

Optionnel

HP_2.16

passengerName

Optionnel

HP_2.16

originAirport

Optionnel

HP_2.16

numberOfRoutingCities

Optionnel

HP_2.16

routingCitiesList

Optionnel

HP_2.16

numberOfAirlineCarriers

Optionnel

HP_2.16

airlineCarriersList

Optionnel

HP_2.16

fareBasis

Optionnel

HP_2.16

numberOfPassengers

Optionnel

HP_2.16

destinationAirport

Optionnel

HP_2.16

reservationCode

Optionnel

HP_2.16

Table 23: Champs relatifs à travelContext

Réponses (automatiques et manuelles)

Le contenu des réponses Web automatiques et manuelles de Sips Paypage est identique. Le contenu lui-même peut varier selon le résultat du paiement (réussi ou autre).

Champ

Dans la version

Commentaires

acquirerNativeResponseCode*

HP_2.12

acquirerResponseCode*

HP_2.0

acquirerResponseIdentifier*

HP_2.8

acquirerResponseMessage*

HP_2.8

additionalAuthorisationNumber*

HP_2.8

amount

HP_1.0

Valeur véhiculée dans la requête de paiement.

authorisationId

HP_1.0

Valeur véhiculée dans la requête de paiement.

avsAddressResponseCode*

HP_2.17

avsPostcodeResponseCode*

HP_2.17

captureDay

HP_1.0

Valeur véhiculée dans la requête de paiement.

captureLimiteDate*

HP_2.3

captureMode

HP_1.0

Valeur véhiculée dans la requête de paiement.

cardCSCResultCode*

HP_2.0

cardProductCode*

HP_2.12

cardProductName*

HP_2.12

cardProductProfile*

HP_2.12

complementaryCode**

HP_1.0

complementaryInfo*

HP_2.0

creditorId*

HP_2.7

currencyCode

HP_1.0

Valeur véhiculée dans la requête de paiement.

customerBusinessName

HP_2.17

customerCompanyName

HP_2.17

customerEmail

HP_2.0

Valeur véhiculée dans la requête de paiement. Seulement disponible en   HP_2.0

customerId

HP_2.0

Valeur véhiculée dans la requête de paiement.

customerIpAddress

HP_2.0

Valeur véhiculée dans la requête de paiement.

customerLegalId

HP_2.17

customerMobilePhone

HP_2.1

Valeur véhiculée dans la requête de paiement. Seulement disponible en HP_2.1

customerPositionOccupied

HP_2.17

dccAmoun*t

HP_2.3

dccCurrencyCode*

HP_2.3

dccExchangeRate*

HP_2.3

dccExchangeRateValidity*

HP_2.3

dccProvider*

HP_2.3

dccStatus*

HP_2.3

dccResponseCode*

HP_2.3

dueDate

HP_2.3

guarantheeIndicator*

HP_2.0

hashPan1*

HP_2.0

hashPan2*

HP_2.0

holderAuthentMethod**

HP_2.4

holderAuthentProgram*

HP_2.5

holderAuthentRelegation*

HP_2.0

holderAuthentStatus*

HP_2.0

instalmentAmountsList*

HP_2.6

instalmentDatesList*

HP_2.6

instalmentNumber*

HP_2.6

instalmentTransactionReferencesList*

HP_2.6

interfaceVersion*

HP_1.0

invoiceReference

HP_2.10

issuerCode*

HP_2.12

issuerCountryCode*

HP_2.12

issuerEnrollementIndicator*

HP_2.0

issuerWalletInformation

HP_2.9

keyVersion*

HP_1.0

Valeur véhiculée dans la requête de paiement.

mandateAuthentMethod*

HP_2.2

mandateCertificationType*

HP_2.7

mandateId*

HP_2.3

mandateUsage*

HP_2.2

maskedPan**

HP_1.0

merchantId

HP_1.0

Valeur véhiculée dans la requête de paiement.

merchantSessionId

HP_2.0

Valeur véhiculée dans la requête de paiement.

merchantTransactionDateTime

HP_2.0

Valeur véhiculée dans la requête de paiement.

merchantWalletId

HP_2.0

Valeur véhiculée dans la requête de paiement.

orderChannel

HP_2.0

Valeur véhiculée dans la requête de paiement.

orderId

HP_1.0

Valeur véhiculée dans la requête de paiement.

panEntryMode*

HP_2.4

panExpiryDate*

HP_2.0

paymentAttemptNumber

HP_2.18

paymentMeanBrand*

HP_1.0

paymentMeanBrandSelectionStatus*

HP_2.14

paymentMeanData*

HP_2.2

paymentMeanId*

HP_2.6

paymentMeanTradingName*

HP_2.8

paymentMeanType*

HP_1.0

paymentPattern*

HP_2.0

Valeur véhiculée dans la requête de paiement.

preAuthenticationColor

HP_2.10

preAuthenticationInfo

HP_2.10

preAuthenticationProfile

HP_2.10

preAuthenticationProfileValue*

HP_2.14

preAuthenticationRuleResultList*

HP_2.14

Une liste d’objet preAuthenticationRuleResult. Veuillez consulter 8.2.2 pour son contenu et 8.2.3 pour son format

preAuthenticationThreshold

HP_2.10

preAuthenticationValue

HP_2.10

preAuthorisationProfile*

HP_2.14

preAuthorisationProfileValue*

HP_2.14

preAuthorisationRuleResultList*

HP_2.14

Une liste d’objet preAuthorisationRuleResult. Veuillez consulter 8.2.1 pour son contenu et 8.2.3 pour son format

responseCode

HP_1.0

returnContext

HP_1.0

Valeur véhiculée dans la requête de paiement.

s10TransactionId

HP_2.9

s10TransactionIdDate

HP_2.9

s10transactionIdsList*

HP_2.11

scoreColor*

HP_2.0

scoreInfo*

HP_2.0

scoreProfile*

HP_2.0

scoreThreshold*

HP_2.0

scoreValue*

HP_2.0

settlementMode

HP_2.7

settlementModeComplement

HP_2.13

statementReference*

HP_2.4

tokenPan*

HP_2.0

transactionActors*

HP_2.2

Valeur véhiculée dans la requête de paiement.

transactionDateTime*

HP_1.0

transactionOrigin*

HP_2.0

Valeur véhiculée dans la requête de paiement.

transactionPlatform

HP_2.16

Usage futur (systématiquement valorisé à ‘PROD’ pour le moment)

transactionReference

HP_1.0

Valeur véhiculée dans la requête de paiement.

walletType*

HP_2.4

Tableau 40: Champs prévus pour la réponse automatique/manuelle au paiement

*: champs renseignés s’ils sont disponibles, en fonction de l’état de la transaction et du moyen de paiement choisi.

Données de PreAuthorisationRuleResult

Field

As of version

Comments

ruleCode

HP_2.14

ruleType

HP_2.14

ruleWeight

HP_2.14

ruleSetting

HP_2.14

ruleResultIndicator

HP_2.14

ruleDetailedInfo

HP_2.14

Table 41: Champs prévus pour l’élément PreAuthorisationRuleResult

Données de PreAuthenticationRuleResult

Field

As of version

Comments

ruleCode

HP_2.14

ruleType

HP_2.14

ruleWeight

HP_2.14

ruleSetting

HP_2.14

ruleResultIndicator

HP_2.14

ruleDetailedInfo

HP_2.14

Table 42: Champs prévus pour l’élément PreAuthenticationRuleResult

Format des Listes Complexes

Le format d'une liste d'objets complexes dans les réponses automatiques et manuelles est définie comme suit: (surligné en jaune)

amount=1000|currencyCode=978|objectNameList=[{"field1":"value1a", "field2":"value2a","field3":"value3a"…},{"field1":"value1b", "field2":"value2b","field3":"value3b"}…]|transactionReference=1452687287828

Le contenu de la liste sont enveloppés dans une paire de crochets [ ].

Chaque entrée de la liste est enveloppé dans une paire d'accolades { }.

Au sein de chaque entrée de la liste, chaque champ est représenté comme "nom_du_champ" = "valeur_du_champ". Notez que le nom et la valeur du champ sont tous deux enveloppés dans une paire de doubles guillemets "". Les paires de nom / valeur adjacents sont séparés par une virgule , .

Example :

amount=1000|currencyCode=978|preAuthenticationRuleResultList=[{“ruleDetailedInfo”:"SHIP_ZIP=A;BILL_ZIP=B",”ruleCode”:"A",”ruleType”:"BBB"},{“ruleDetailedInfo”:"SHIP_ZIP=C;BILL_ZIP=D",”ruleCode”:"A",”ruleType”:"BBB"}]|transactionReference=1452687287828

Gestion des erreurs

Tous les champs reçus par Mercanet  Essentiel POST à travers le connecteur font l’objet d’une vérification individuelle. Le tableau ci-dessous présente la liste des messages d’erreur pouvant s’afficher lors de cette étape ainsi que les solutions à mettre en œuvre.

Message

Cause

Solution

Version d’interface inconnue : <version>

La valeur <version> dans le champ POST InterfaceVersion est inconnue

Vérifier la version d’interface dans ce guide d’utilisation

Mot-clé invalide : <nom du paramètre>=<valeur du paramètre>

La demande contient un réglage <nom du paramètre> qui n’est pas prévu dans la demande de paiement

Vérifier les réglages de la demande de paiement dans le dictionnaire de données

Taille du champ incorrecte : <nom du paramètre>=<valeur du paramètre>

La valeur du réglage <nom du paramètre> a une longueur incorrecte

Vérifier la longueur des réglages de la demande de paiement dans le dictionnaire de données

Valeur du champ incorrecte : <nom du paramètre>=<valeur du paramètre>

La valeur du réglage <nom du paramètre> a un format incorrect

Vérifier le format des réglages de la demande de paiement dans le dictionnaire de données

Champ obligatoire manquant : <nom du paramètre>

Le réglage obligatoire <nom du paramètre> est manquant dans la demande de paiement

Vérifier les réglages obligatoires de la demande de paiement dans le dictionnaire de données

Version de sécurisation inconnue : <version>

La valeur <version> dans le réglage keyVersion est inconnue

Vérifier les versions des clés disponibles dans l’interface du Commerçant

Signature invalide

La vérification de la signature de la demande de paiement a échoué. Cela peut être causé par le calcul incorrect de la signature ou peut indiquer la falsification de certains champs après le calcul de la signature.

Vérifier les régulations concernant le calcul de la signature dans le dictionnaire de données

Transaction déjà effectuée : <référence de la transaction>

Une demande de paiement avec la même transactionReference a déjà été reçue et prise en charge par les serveurs Mercanet

Vérifier si le paramètre transactionReference est unique pour la transaction concernée

<Autres messages>

Dans le cas d’erreurs techniques, d’autres messages différents peuvent s’afficher

Contacter le service d’assistance technique