Comment configurer votre compte ?

Vous devez vous rapprocher de votre responsable de compte pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (contrat et le nom de la banque).
Ensuite veuillez adresser un email à notre équipe support avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.

Contactez le support Monext Online.

Le code (card_code) du moyen de paiement est : CADHOC

Comment proposer le paiement Cadhoc à vos clients ?

Les principes d’utilisation

Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline en indiquant le contrat du moyen de paiement Contrat_Number.
Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetails.
Le mode d'intégration avec l'API DirectPayment avec le service doAuthorization.

Les web services en mode Web

Interfaces de paiement : API WebPayment, Cente d'administration, TPEV, Batch.
Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
Paiement à l'expédition : en utilisant les services doWebPayment et doCapture avec le code Mode à CPT et code Action à 100.
Mode de paiement : comptant avec le code Mode = CPT.

Les champs obligatoires

Les champs obligtoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.

Nom du champ	Type
Id transaction	Libellé
Numéro de carte	PAN masqué
Type = Cadhoc	Libellé
Date d’expiration	Date
Montant	Montant avec code devise

Comment réaliser des tests ?

Il vous faut obtenir une carte de test auprès du processeur UP.

Les codes de retour

Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement.

pour l'API WebPayment avec le service getWebPaymentDetails,
pour l'API DirectPayment en réponse du service doAuthorization de manière synchrone ou getTransactionDetails en réponse asynchrone.

Les états retournés :

Le paiement est accepté avec l'état ACCEPTED et le code retour 00000.
Le paiement est refusé avec l'état REFUSED. Le code varie en fonction du motif de refus (Par exemple : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).

La gestion des états et des codes retour sont listés ici.

Liste des codes retour les plus utilisés :

Reset : non; l'erreur suivante est retournée 02621 - Operation not allowed on this site
Debit (204) : non; l'erreur suivante est retournée 36016 - Requested function not available
Credit (422) : non; l'erreur suivante est retournée 36016 - Requested function not available

Code	ShortMessage	LongMessage
36000	ONHOLD_PARTNER	Credit Transaction In progress
36001	REFUSED	Transaction refused
36002	ERROR	Payment partner error
36003	REFUSED	Transaction charges
36004	REFUSED	Transaction is charging
36005	ACCEPTED	Transaction refunded
36010	ERROR	Unreachable host
36011	ERROR	The fields shippingAddress.title, shippingAddress.firstname, shippingAddress.lastname, shippingAddress.name, shippingAddress.street1, shippingAddress.zipCode, shippingAddress.cityName, shippingAddress.country of object buyer are mandatory.
36012	ERROR	The fields billingAddress.title, billingAddress.firstname, billingAddress.lastname, billingAddress.name, billingAddress.street1, billingAddress.zipCode, billingAddress.cityName, billingAddress.country of object buyer are mandatory.
36013	ERROR	The fields order.deliveryMode, order.deliveryTime, order.deliveryexpectedDate, order.deliveryexpectedDelay, details.ref, details.comment, details.price, details.quantity, details.category, details.brand are mandatory.
36014	ERROR	Syntax error.
36015	ERROR	Invalid amount.
36016	REFUSED	Requested function not available
36017	ERROR	Invalid title
36018	ERROR	Invalid Item Category
36019	ERROR	Invalid expected delivery date
36020	ERROR	Invalid data. Refer to transaction details.
36025	ERROR	Operation not allowed. Refer to transaction details.
36030	ERROR	Operation refused.
36500	ERROR	Remote error.
36505	ERROR	Unreachable host.
36940	ERROR	Syntax error.
36941	ERROR	Authentication error.
36943	ERROR	Unauthorised request.
36944	ERROR	Unknown transaction.
36945	ERROR	Unauthorised http primitive.
36950	ERROR	Error.

Exemple de trame SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:impl="http://impl.ws.payline.experian.com" xmlns:obj="http://obj.ws.payline.experian.com">
   <soapenv:Header/>
   <soapenv:Body>
      <impl:doWebPaymentRequest>
         <impl:version>9</impl:version>
         <impl:payment>
            <obj:amount>100</obj:amount>
            <obj:currency>978</obj:currency>
            <obj:action>100</obj:action>
            <obj:mode>CPT</obj:mode>
            <obj:contractNumber>CADHOC_01</obj:contractNumber>
            <!--Optional:-->
            <obj:differedActionDate></obj:differedActionDate>
            <!--Optional:-->
            <obj:method></obj:method>
            <obj:softDescriptor></obj:softDescriptor>
            <!--Optional:-->
            <obj:cardBrand></obj:cardBrand>
         </impl:payment>
         <impl:returnURL>http://www.soapui.org/</impl:returnURL>
         <impl:cancelURL>http://sahi.co.in/</impl:cancelURL>
         <impl:order>
            <obj:ref>CTUx30371</obj:ref>
            <!--Optional:-->
            <obj:origin></obj:origin>
            <!--Optional:-->
            <obj:country></obj:country>
            <!--Optional:-->
            <obj:taxes></obj:taxes>
            <obj:amount>11000</obj:amount>
            <obj:currency>978</obj:currency>
            <obj:date>06/07/2014 10:19</obj:date>
            <!--Optional:-->
            <obj:details>
               <!--0 to 100 repetitions:-->
               <obj:details>
                  <!--Optional:-->
                  <obj:ref>00001 (ref1)</obj:ref>
                  <!--Optional:-->
                  <obj:price>50</obj:price>
                  <!--Optional:-->
                  <obj:quantity>1</obj:quantity>
                  <!--Optional:-->
                  <obj:comment>comment1 (rem1)</obj:comment>
                  <!--Optional:-->
                  <obj:category>1</obj:category>
                  <!--Optional:-->
                  <obj:brand>My HERMES (brd1)</obj:brand>
                  <!--Optional:-->
                  <obj:subcategory1>BOSS</obj:subcategory1>
                  <!--Optional:-->
                  <obj:subcategory2>MONTRE</obj:subcategory2>
                  <!--Optional:-->
                  <obj:additionalData>LegalAge=18;Discount=0105</obj:additionalData>
                  <!--Optional:-->
                  <obj:taxRate>1234</obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref>00002 (ref2)</obj:ref>
                  <obj:price>50</obj:price>
                  <obj:quantity>1</obj:quantity>
                  <obj:comment>comment2 (rem2)</obj:comment>
                  <obj:category>1</obj:category>
                  <obj:brand>My HERMES (brd2)</obj:brand>
                  <obj:subcategory1>HERMES</obj:subcategory1>
                  <obj:subcategory2>FOULARD</obj:subcategory2>
                  <obj:additionalData>LegalAge=18;Discount=0105</obj:additionalData>
                  <obj:taxRate>1234</obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref>00003 (ref3)</obj:ref>
                  <obj:price>50</obj:price>
                  <obj:quantity>1</obj:quantity>
                  <obj:comment>comment3 (rem3)</obj:comment>
                  <obj:category>1</obj:category>
                  <obj:brand>My HERMES (brd3)</obj:brand>
                  <obj:subcategory1>HERMES</obj:subcategory1>
                  <obj:subcategory2>MONTRE</obj:subcategory2>
                  <obj:additionalData>LegalAge=19;Discount=0105</obj:additionalData>
                  <obj:taxRate>1234</obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref>00004 (ref4)</obj:ref>
                  <obj:price>50</obj:price>
                  <obj:quantity>1</obj:quantity>
                  <obj:comment>comment4 (rem4)</obj:comment>
                  <obj:category>1</obj:category>
                  <obj:brand>My HERMES (brd4)</obj:brand>
                  <obj:subcategory1>HERMES</obj:subcategory1>
                  <obj:subcategory2>MONTRE</obj:subcategory2>
                  <obj:additionalData>LegalAge=18;Discount=0105</obj:additionalData>
                  <obj:taxRate>4321</obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref>00005 (ref5)</obj:ref>
                  <obj:price>51</obj:price>
                  <obj:quantity>1</obj:quantity>
                  <obj:comment>comment5 (rem5)</obj:comment>
                  <obj:category>1</obj:category>
                  <obj:brand>My HERMES (brd5)</obj:brand>
                  <obj:subcategory1>HERMES</obj:subcategory1>
                  <obj:subcategory2>MONTRE</obj:subcategory2>
                  <obj:additionalData>LegalAge=18;Discount=0105</obj:additionalData>
                  <obj:taxRate>1234</obj:taxRate>
               </obj:details>
               <!--<obj:details>
                  <obj:ref></obj:ref>
                  <obj:price></obj:price>
                  <obj:quantity></obj:quantity>
                  <obj:comment></obj:comment>
                  <obj:category></obj:category>
                  <obj:brand></obj:brand>
                  <obj:subcategory1></obj:subcategory1>
                  <obj:subcategory2></obj:subcategory2>
                  <obj:additionalData></obj:additionalData>
                  <obj:taxRate></obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref></obj:ref>
                  <obj:price></obj:price>
                  <obj:quantity></obj:quantity>
                  <obj:comment></obj:comment>
                  <obj:category></obj:category>
                  <obj:brand></obj:brand>
                  <obj:subcategory1></obj:subcategory1>
                  <obj:subcategory2></obj:subcategory2>
                  <obj:additionalData></obj:additionalData>
                  <obj:taxRate></obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref></obj:ref>
                  <obj:price></obj:price>
                  <obj:quantity></obj:quantity>
                  <obj:comment></obj:comment>
                  <obj:category></obj:category>
                  <obj:brand></obj:brand>
                  <obj:subcategory1></obj:subcategory1>
                  <obj:subcategory2></obj:subcategory2>
                  <obj:additionalData></obj:additionalData>
                  <obj:taxRate></obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref></obj:ref>
                  <obj:price></obj:price>
                  <obj:quantity></obj:quantity>
                  <obj:comment></obj:comment>
                  <obj:category></obj:category>
                  <obj:brand></obj:brand>
                  <obj:subcategory1></obj:subcategory1>
                  <obj:subcategory2></obj:subcategory2>
                  <obj:additionalData></obj:additionalData>
                  <obj:taxRate></obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref></obj:ref>
                  <obj:price></obj:price>
                  <obj:quantity></obj:quantity>
                  <obj:comment></obj:comment>
                  <obj:category></obj:category>
                  <obj:brand></obj:brand>
                  <obj:subcategory1></obj:subcategory1>
                  <obj:subcategory2></obj:subcategory2>
                  <obj:additionalData></obj:additionalData>
                  <obj:taxRate></obj:taxRate>
               </obj:details>
               <obj:details>
                  <obj:ref></obj:ref>
                  <obj:price></obj:price>
                  <obj:quantity></obj:quantity>
                  <obj:comment></obj:comment>
                  <obj:category></obj:category>
                  <obj:brand></obj:brand>
                  <obj:subcategory1></obj:subcategory1>
                  <obj:subcategory2></obj:subcategory2>
                  <obj:additionalData></obj:additionalData>
                  <obj:taxRate></obj:taxRate>
               </obj:details>-->
            </obj:details>
            <!--Optional:-->
            <obj:deliveryTime>1</obj:deliveryTime>
            <!--Optional:-->
            <obj:deliveryMode>1</obj:deliveryMode>
            <!--Optional:-->
            <obj:deliveryExpectedDate>31/08/2017</obj:deliveryExpectedDate>
            <!--Optional:-->
            <obj:deliveryExpectedDelay>1</obj:deliveryExpectedDelay>
         </impl:order>
         <impl:notificationURL></impl:notificationURL>
         <impl:selectedContractList>
            <!--1 to 25 repetitions:-->
            <obj:selectedContract>CADHOC_01</obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
         </impl:selectedContractList>
         <impl:secondSelectedContractList>
            <!--1 to 25 repetitions:-->
            <obj:selectedContract></obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
            <obj:selectedContract></obj:selectedContract>
         </impl:secondSelectedContractList>
         <impl:privateDataList>
            <!--0 to 100 repetitions:-->
            <obj:privateData>
               <obj:key>key1</obj:key>
               <obj:value>value1</obj:value>
            </obj:privateData>
            <!--<obj:privateData>
               <obj:key>PAYLINE.PRE_SCORE</obj:key>
               <obj:value>21330</obj:value>
            </obj:privateData>
            <obj:privateData>
               <obj:key></obj:key>
               <obj:value></obj:value>
            </obj:privateData>
            <obj:privateData>
               <obj:key></obj:key>
               <obj:value></obj:value>
            </obj:privateData>
            <obj:privateData>
               <obj:key></obj:key>
               <obj:value></obj:value>
            </obj:privateData>-->
         </impl:privateDataList>
         <impl:languageCode></impl:languageCode>
         <impl:customPaymentPageCode></impl:customPaymentPageCode>
         <impl:buyer>
            <obj:title>M</obj:title>
            <obj:lastName>TUPU</obj:lastName>
            <obj:firstName>Christian</obj:firstName>
            <obj:email>christian.tupu@monext.net</obj:email>
            <obj:shippingAdress>
               <!--Optional:-->
               <obj:title>2</obj:title>
               <!--Optional:-->
               <obj:name>BUYER (shipping)</obj:name>
               <!--Optional:-->
               <obj:firstName>Validation Team (shipping)</obj:firstName>
               <!--Optional:-->
               <obj:lastName>PAYLINE (shipping)</obj:lastName>
               <!--Optional:-->
               <obj:street1>Colombus Circle (shipping)</obj:street1>
               <!--Optional:-->
               <obj:street2>Central Park (shipping)</obj:street2>
               <!--Optional:-->
               <obj:cityName>New York (shipping)</obj:cityName>
               <!--Optional:-->
               <obj:zipCode>NY 10023</obj:zipCode>
               <!--Optional:-->
               <obj:country>france</obj:country>
               <!--Optional:-->
               <obj:phone>0123458789</obj:phone>
               <!--Optional:-->
               <obj:state>NYC (state)</obj:state>
               <!--Optional:-->
               <obj:county>Upper East Side (shipping)</obj:county>
               <!--Optional:-->
               <obj:phoneType>1</obj:phoneType>
            </obj:shippingAdress>
            <obj:billingAddress>
               <!--Optional:-->
               <obj:title>3</obj:title>
               <!--Optional:-->
               <obj:name>BUYER (billing)</obj:name>
               <!--Optional:-->
               <obj:firstName>Christian (billing)</obj:firstName>
               <!--Optional:-->
               <obj:lastName>TUPU (billing)</obj:lastName>
               <!--Optional:-->
               <obj:street1>260, rue Claude Nicolas Ledoux</obj:street1>
               <!--Optional:-->
               <obj:street2>ComplÃ©ment d'adresse</obj:street2>
               <!--Optional:-->
               <obj:cityName>AIX EN PROVENCE</obj:cityName>
               <!--Optional:-->
               <obj:zipCode>13593</obj:zipCode>
               <!--Optional:-->
               <obj:country>FR</obj:country>
               <!--Optional:-->
               <obj:phone>0442251515</obj:phone>
               <!--Optional:-->
               <obj:state></obj:state>
               <!--Optional:-->
               <obj:county>Bouches-du-RhÃ´ne</obj:county>
               <!--Optional:-->
               <obj:phoneType>4</obj:phoneType>
            </obj:billingAddress>
            <obj:accountCreateDate></obj:accountCreateDate>
            <obj:accountAverageAmount></obj:accountAverageAmount>
            <obj:accountOrderCount></obj:accountOrderCount>
            <obj:walletId></obj:walletId>
            <obj:walletDisplayed></obj:walletDisplayed>
            <obj:walletSecured></obj:walletSecured>
            <obj:walletCardInd></obj:walletCardInd>
            <obj:ip>172.22.120.218,172.0.0.3</obj:ip>
            <obj:mobilePhone></obj:mobilePhone>
            <obj:customerId>CTU</obj:customerId>
            <obj:legalStatus>1</obj:legalStatus>
            <obj:legalDocument>83006389468</obj:legalDocument>
            <obj:birthDate>1981-12-29</obj:birthDate>
            <obj:fingerprintID></obj:fingerprintID>
            <obj:deviceFingerprint></obj:deviceFingerprint>
            <obj:isBot></obj:isBot>
            <obj:isIncognito></obj:isIncognito>
            <obj:isBehindProxy></obj:isBehindProxy>
            <obj:isFromTor></obj:isFromTor>
            <obj:isEmulator></obj:isEmulator>
            <obj:isRooted></obj:isRooted>
            <obj:hasTimezoneMismatch></obj:hasTimezoneMismatch>
         </impl:buyer>
         <impl:owner>
            <obj:lastName>owner.lastName</obj:lastName>
            <obj:firstName>owner.firstName</obj:firstName>
            <obj:billingAddress>
               <obj:street>owner.billingAddress</obj:street>
               <obj:cityName>owner.billingAddress.cityName</obj:cityName>
               <obj:zipCode>zipCode 3</obj:zipCode>
               <obj:country>owner.billingAddress.country</obj:country>
               <obj:phone>0323458789</obj:phone>
            </obj:billingAddress>
            <obj:issueCardDate></obj:issueCardDate>
         </impl:owner>
         <impl:securityMode>SSL</impl:securityMode>
         <impl:recurring>
            <obj:firstAmount>51</obj:firstAmount>
            <obj:amount>100</obj:amount>
            <obj:billingCycle>10</obj:billingCycle>
            <obj:billingLeft>3</obj:billingLeft>
            <obj:billingDay></obj:billingDay>
            <obj:startDate></obj:startDate>
            <obj:endDate></obj:endDate>
            <obj:newAmount></obj:newAmount>
            <obj:amountModificationDate></obj:amountModificationDate>
         </impl:recurring>
         <impl:customPaymentTemplateURL></impl:customPaymentTemplateURL>
        <impl:contractNumberWalletList>
            <!--0 to 10 repetitions:-->
            <obj:contractNumberWallet></obj:contractNumberWallet>
            <obj:contractNumberWallet></obj:contractNumberWallet>
            <obj:contractNumberWallet></obj:contractNumberWallet>
            <obj:contractNumberWallet></obj:contractNumberWallet>
            <obj:contractNumberWallet></obj:contractNumberWallet>
         </impl:contractNumberWalletList>
         <impl:merchantName></impl:merchantName>
      </impl:doWebPaymentRequest>
   </soapenv:Body>
</soapenv:Envelope>

Pages associées

Page:

Intégration 3D Secure 2 en mode API WebPayment
Page:

Intégration API WebPayment
Page:

PW - Intégration Widget
Page:

PW - L'API JavaScript
Page:

PW - Personnalisation du widget : Balises CSS
Page:

PW - Personnalisation du widget : Feuille de style
Page:

PW - Personnalisation du widget : Fonction CallBack

Page tree

Cadhoc - Intégration