Manuel d'intégration Trusted Shops

Manuel d'intégration Trusted Shops

Label de Qualité Trusted Shops avec protection acheteurs EXCELLENCE

Version 2.5 fr-FR © 2015 Trusted Shops GmbH

Manuel d'intégration pour e-commerçants - EXCELLENCE

© 2015 Trusted Shops GmbH4 2

Table des matières

1. Le label de qualité Trusted Shops avec protection acheteurs .............................. 3 1.1 La protection acheteurs Trusted Shops ................................................................................... 3 1.2 Webservice Trusted Shops pour la souscription d'une protection acheteurs .......................... 5 1.3 Traitement des erreurs ............................................................................................................. 9 1.4 Intégration de la protection acheteurs dans le front-end de la boutique................................ 11 1.5 Trustbadge Trusted Shops avec Trustcard ........................................................................... 12

2. Assistance ............................................................................................................... 12



Fig. 1 : Représentation schématisée de la protection acheteurs Excellence Trusted Shops

1. Le label de qualité Trusted Shops avec protection acheteurs

1.1 La protection acheteurs Trusted Shops

1.1.1 Fonctionnement

L'option offerte de souscrire une protection acheteurs Trusted Shops est affichée dans la boîte de

dialogue de protection acheteurs lors de la sélection du mode de paiement en phase de vérification.

La protection acheteurs peut être activée ou désactivée dans la boutique par l'acheteur grâce à une

case à cocher. Si le client a choisi de souscrire à la protection acheteurs Trusted Shops, cette

dernière est ajoutée comme un produit à la commande.

De manière générale, la case à cocher est décochée par défaut. Cela s'applique également lorsque

le client quitte la page et la réouvre ensuite, s'il a par exemple ajouté de nouveaux produits au panier

entre temps. En fonction du montant du panier (valeur des marchandises + frais de port), le produit

protection acheteurs Trusted Shops correspondant doit être affiché. Le produit correspondant devra a

minima couvrir le montant de la commande dans sa totalité (par exemple pour un achat d'un montant

de 600,00 €, il s'agira du produit « Protection acheteurs Trusted Shops jusqu'à 1500,00 € »).

Sur la page de l'aperçu de la commande, le produit Protection acheteurs est ajouté aux produits

commandés, frais de ports inclus, pour former le prix total. Après confirmation de la commande, le

Webservice de protection acheteurs Trusted Shops s’ouvre à l'aide de la méthode

requestForProtectionV2() avec les paramètres correspondants. Dans un délai court,

l'ouverture de getRequestState() vérifie si Trusted Shops a accepté la demande de prise en

charge de la garantie. Puis, la garantie est validée dans le système Trusted Shops et le client est

informé par voie électronique. Les garanties conclues sont consultables sur le login de la boutique

sous https://www.trustedshops.com/fr/shop/login.html.

Le site marchand est tenu de s'assurer que toutes les demandes de protection acheteurs sont

arrivées par le biais de l'interface et que les garanties ont été conclues avec succès.

1.1.2 Déroulement schématisé dans la boutique

La protection acheteurs Trusted Shop est proposée en même temps que la sélection du mode de

paiement lors du processus de vérification.



Fig. 2 : Déroulement technique de la protection acheteurs Excellence Trusted Shops

1.1.3 Déroulement technique

1.1.4 Propriétés et calcul des produits de protection acheteurs

La protection acheteurs Trusted Shops est conclue en ajoutant un produit Protection acheteurs dans

le panier au cours du processus de commande.

La désignation des produits Protection acheteurs concernés contient le montant maximal garanti

ainsi que la durée de garantie. Le produit TS080501_500_30_EUR fait par exemple référence à une

protection acheteurs d'un montant maximal de 500,00 € avec une durée de 30 jours.

Veuillez sauvegarder les produits Protection acheteurs Trusted Shops suivants sur votre boutique

dans la mesure où l'on ne vous a pas transmis de produits différents.

ID du produit Trusted Shops (tsProductId) Prix net

TS080501_500_30_EUR 0,82353 EUR

TS080501_1500_30_EUR 2,47059 EUR

TS080501_2500_30_EUR 4,11765 EUR

TS080501_5000_30_EUR 8,23530 EUR

TS080501_10000_30_EUR 16,47060 EUR

TS080501_20000_30_EUR 32,94120 EUR

Concernant les produits Protection acheteurs, les règles suivantes s'appliquent :

Les produits Protection acheteurs Trusted Shops sont enregistrés sur la boutique ou dans la

base de données, mais ils ne sont pas visibles dans le catalogue produits de la boutique.

Les produits Protection acheteurs peuvent uniquement être réservés lors du processus de

vérification.

Les produits Protection acheteurs sont disponibles de manière illimitée.

Le panier ne peut contenir qu’un seul et unique produit Protection acheteurs.

Les produits Protection acheteurs sont toujours enregistrés avec leur prix net.



Les produits Protection acheteurs sont soumis à la TVA applicable à l'ensemble de la

prestation. Dans la mesure où les produits sont soumis à un taux de TVA unique, celui-ci fait

foi. Si les produits contenus dans un panier sont soumis à différents taux de TVA, nous

recommandons l'application du taux de TVA le plus élevé. La boutique devra clarifier les

détails individuellement avec son conseiller fiscal.

Le prix des produits Protection acheteurs est affiché dans la boutique en fonction des prix

des autres produits, c'est-à-dire en prix brut dans le domaine du commerce B2C et en prix

net dans le domaine du commerce B2B.

Le montant des produits Protection acheteurs Trusted Shops accroît le montant total de la

commande. La protection acheteurs Trusted Shops est toutefois uniquement conclue sur les

produits de la boutique et les prestations de transport correspondantes; la protection

acheteurs ne se couvre pas elle-même.

Aucun rabais n'est concédé sur les produits Protection acheteurs.

Dans l'exemple suivant, le montant de la commande s'élève à 195,99 €, la protection acheteurs est

demandée sur un montant de 195,00 € :

Exemple de facture (19,6% TVA incluse):

Produit 1

Produit 2

Rabais en fonction du mode de paiement 5%

Frais de port

Protection acheteurs Trusted Shops jusqu'à 500,00 €

Montant de la facture

150,00 EUR

50,00 EUR

- 10,00 EUR

5,00 EUR

0,99 EUR

------------

195,99 EUR

1.1.5 Gestion des certificats Trusted Shops

Le certificat Trusted Shops est identifié par le biais d'un code alphanumérique de 33 caractères, l'ID

Trusted Shops (TS-ID). L'ID Trusted Shops est transmise à l'e-commerçant après son inscription

auprès de Trusted Shops. Une ID Trusted Shops s'applique toujours à une seule URL de boutique

d'une seule langue. Si un système de boutique utilise plusieurs boutiques en ligne ou dispose de

plusieurs versions de langue différente, chaque instance individuelle doit se voir attribuer son propre

ID Trusted Shops. En outre, un identifiant Webservice (WSLogin) est attribué à chaque certificat

Trusted Shops, grâce auquel la protection acheteurs peut être demandée.

1.2 Webservice Trusted Shops pour la souscription d'une protection acheteurs

Ce webservice destiné au front-end de la boutique dispose de deux méthodes pour la souscription et

la vérification de la protection acheteurs.

Le webservice pour la souscription d'une protection acheteurs est disponible par le biais des URL

suivantes auprès de Trusted Shops.

URL Webservice pour l'environnement test (« Sandbox »)

https://protection-

qa.trustedshops.com/ts/protectionservices/ApplicationRequestService?wsdl

URL Webservice pour l'environnement productif

https://protection.trustedshops.com/ts/protectionservices/ApplicationReques

tService?wsdl

1.2.1 requestForProtectionV2()

La méthode requestForProtectionV2() représente la fonction centrale au sein du processus de

souscription d'une garantie de protection acheteurs. Les données transactionnelles nécessaires pour



un achat sont transmises à Trusted Shops, le Webservice établit une demande de protection

acheteurs. Les demandes sont vérifiées en termes de validité formelle chez Trusted Shop,

sauvegardées et traitées à intervalles réguliers.

Veuillez également tenir compte des informations concernant le traitement des erreurs pour garantir

à tout moment la bonne réception de toutes les demandes de protection acheteurs par le biais de

l'interface.

1.2.1.1 Désignation et type de données

Définition WSDL :

<message name="ApplicationRequestService_requestForProtectionV2">

<part name="tsId" type="xsd:string"/>

<part name="tsProductId" type="xsd:string"/>

<part name="amount" type="xsd:decimal"/>

<part name="currency" type="xsd:string"/>

<part name="paymentType" type="xsd:string"/>

<part name="buyerEmail" type="xsd:string"/>

<part name="shopCustomerID" type="xsd:string"/>

<part name="shopOrderID" type="xsd:string"/>

<part name="orderDate" type="xsd:dateTime"/>

<part name="shopSystemVersion" type="xsd:string"/>

<part name="wsUser" type="xsd:string"/>

<part name="wsPassword" type="xsd:string"/>

</message>

1.2.1.2 Paramètres

Paramètre Description Commentaire

tsID ID Trusted Shops du certificat

Obligatoire, est attribuée par Trusted Shops pour chaque certificat ; chaque langue de la boutique et chaque boutique d'une solution appelée « multiboutiques » nécessitent un certificat propre.

tsProductID Code produit Protection acheteurs

Obligatoire, voir tableau des produits Protection acheteurs

amount Montant de la facture, frais de port compris

Obligatoire, format numérique décimal

avec deux chiffres après le point (par ex. 3130.47)

currency Devise de l'achat, ISO 4217 3 caractères

Obligatoire, par ex. code ISO pour l'Euro = EUR

paymentType Constante de mode de paiement

Obligatoire, spécifique à Trusted Shops, voir liste des modes de paiement disponibles.

buyerEmail Adresse électronique de l'acheteur

Obligatoire

shopCustomerID Numéro client de l'acheteur Obligatoire, saisir la valeur constante « 0 » si aucune valeur ne lui a été attribuée

shopOrderID Numéro de commande de l'acheteur

Obligatoire

orderDate Date de la commande sur la boutique en ligne

Obligatoire, Format : 2011-10-31T09:30:00

http://fr.wikipedia.org/wiki/ISO_4217



shopSystemVersion

Version du logiciel de la boutique ou du module Trusted Shops, par ex. : « topshop v2.1 »

Obligatoire, chaîne au choix

wsUser Utilisateur du Webservice Obligatoire, est attribué séparément par Trusted Shops pour chaque certificat

wsPassword Mot de passe Webservice Obligatoire, est attribué séparément par Trusted Shops pour chaque certificat

1.2.1.3 Valeurs de retour

Une valeur de retour positive signifie que la demande Webservice a été traitée avec succès, la valeur

correspondant au numéro de demande Protection acheteurs. Une valeur de retour négative renvoie à

une erreur, la valeur représentant le code erreur.

1.2.1.4 Exemple de code (PHP)

La partie ci-après décrit un exemple d'ouverture de l'interface acheteur après achèvement de la

commande par le client final. La condition préalable est l'extension PHP 5 SOAP. Les passages

surlignés doivent être corrigés en fonction des besoins.

Exemple de code PHP (veuillez remplacer le texte surligné en jaune) :

define("SOAP_ERROR", -1);

define("TS_SERVER", "protection.trustedshops.com");

# Collect parameters for the webservice call

# TS-ID received by Trusted Shops

$tsId = "X1234567890ABCDEFGHJKLMNOPQRSTUVW";

# Defined by Trusted Shops, depends on order total amount

$tsProductId = "TS080501_500_30_EUR";

$orderDate = date("Y-m-d", time()) . "T" . date("H:i:s", time());

$shopSystemVersion = "Shop 4.0 TS.01";

# Collect other parameters

$decimalAmount = (double) $amount;

# ...

# Call TS protection webservice

$ini = ini_set("soap.wsdl_cache_enabled", 1);

try

{

$wsdlUrl = "https://" . TS_SERVER .

"/ts/protectionservices/ApplicationRequestService?wsdl";

$client = new SoapClient($wsdlUrl);

# Set return value for the case if a SOAP exception occurs

$returnValue = SOAP_ERROR;

# call WS method

$returnValue = $client-> requestForProtectionV2 ($tsId, $tsProductId,

(double)$amount, $currency, $paymentType, $buyerEmail, $shopCustomerID,

$shopOrderID, $orderDate, $shopSystemVersion, $wsUser, $wsPassword);

} catch (SoapFault $fault) {

$errorText = "SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault-

>faultstring})";

echo $errorText;

}

# Check return value

# Negative return value is an error code, positive value is the application number

if ($returnValue == SOAP_ERROR)

{



echo "SOAP error: $errorText";

} else if ($returnValue < 0)

{

error_log "TS Webservice returns error code $returnValue";

switch ($returnValue)

{

case -10001 :

echo "Cause: login failed or no valid shop found for tsId '$tsId'";

break;

...

}

} else

{

echo "TS Webservice has successfully returned application number

'$returnValue'";

}

1.2.1.5 Modes de paiement

Lors de la souscription à la protection acheteurs Trusted Shops, le mode de paiement choisi par le

client est transmis à Trusted Shops. Les modes de paiement pris en charge par Trusted Shops sont

désignés comme suit. Veuillez affecter les modes de paiement utilisés dans la boutique aux modes

de paiement Trusted Shops.

Code FR

DIRECT_DEBIT Prélèvement bancaire

CREDIT_CARD Carte de crédit

INVOICE Facture

CASH_ON_DELIVERY Envoi contre remboursement

PREPAYMENT Paiement / Virement préalable

CHEQUE Chèque bancaire

PAYBOX Paybox

PAYPAL PayPal

AMAZON_PAYMENTS Amazon payments

CASH_ON_PICKUP Paiement à l’enlèvement

FINANCING Financement

LEASING Leasing

T_PAY T-Pay

CLICKANDBUY Click&Buy

GIROPAY Giropay

GOOGLE_CHECKOUT Google Checkout

SHOP_CARD Carte de paiement de la boutique en ligne



DIRECT_E_BANKING SOFORT Banking

MONEYBOOKERS moneybookers.com

DOTPAY Dotpay

PLATNOSCI Płatności

PRZELEWY24 Przelewy24

OTHER Autre mode de paiement

1.2.2 getRequestState()

La méthode getRequestState() permet de consulter le statut de la demande de garantie et de

retourner le numéro de garantie en cas de validation.

Une valeur de retour positive de requestForProtectionV2() signifie que la demande de

protection acheteurs a été transmise avec succès et qu'elle se trouve dans une file d'attente de

messages chez Trusted Shops. Les erreurs sémantiques sont toutefois uniquement détectées lors de

la phase de traitement de la demande (par ex. numéro de commande manquant ou en doublon). En

ouvrant getRequestState(), l'on vérifie ainsi si les demandes de prise en charge de garantie requises

à l'aide de requestForProtectionV2() ont été acceptées par Trusted Shops, car seule une

demande traitée avec succès donne naissance à une garantie Trusted Shops. Trusted Shops vous

recommande d'automatiser l'ouverture à un intervalle de 10 minutes à l'aide d'une tâche cron.

La demande de protection acheteurs sur la boutique et la confirmation par Trusted Shops n'ayant pas

lieu en même temps, il est nécessaire de mettre en place un traitement des erreurs. En cas

d'interruptions de Trusted Shops ou d'exceptions SOAP, la garantie peut être renouvelée jusqu'à

trois jours plus tard (avec des données transactionnelles réparées).

1.2.2.1 Désignation et type de données

Définition WSDL :

<message name="ApplicationRequestService_getRequestState">

<part name="tsId" type="xsd:string"/>

<part name="applicationId" type="xsd:long"/>

</message>

1.2.2.2 Paramètres

Paramètre Description Commentaire

tsID ID Trusted Shops du certificat

Obligatoire, est attribuée par Trusted Shops pour chaque certificat ; chaque langue de la boutique et chaque boutique d'une solution appelée « multiboutiques » nécessitent un certificat propre.

applicationID Numéro de la demande Protection acheteurs

Obligatoire, valeur de retour de requestForProtectionV2()

1.2.2.3 Valeurs de retour

Une valeur de retour positive signifie que la demande Webservice a été traitée avec succès, la valeur

correspondant au numéro de la garantie. Une valeur de retour négative renvoie à une erreur, la

valeur représentant le code erreur.

1.3 Traitement des erreurs

Lors de la phase d'intégration et d'utilisation en production, enregistrez les codes erreur et les

exceptions SOAP pour détecter rapidement les erreurs d'intégration ou de configuration. Eu égard



aux erreurs d'exception survenant éventuellement ou de la non disponibilité du site Internet Trusted

Shops, un traitement des erreurs garantit toutefois que toute demande de protection acheteurs arrive

chez Trusted Shops. Le site marchand est responsable de la bonne transmission de toutes les

demandes de protection acheteurs à Trusted Shops. Les demandes de protection acheteurs peuvent

être renouvelées avec des données corrigées dans un délai de trois jours. Le statut actuel d'une

garantie peut être vérifié à l'aide de la méthode getRequestState().

Fonction Description Commentaire

Traitement de la file d'attente

Sauvegarde et traitement des demandes de garantie

Obligatoire, par ex. à l'aide de la fonction Réessayer au maximum 3 fois dans un intervalle de 8 heures avant interruption

Enregistrement Enregistrement dans un journal des demandes de garantie, des codes d'erreur, des exceptions SOAP etc.

Obligatoire, par ex. sous forme d'une liste de validation des garanties conclues dans le tableau de bord de l'administration de la boutique

1.3.1 Codes erreur

Code Valeur de retour Cause

-10001 NO_VALID_SHOP L'identifiant Webservice ou l'ID TS ne sont pas valides

-10002 LIMIT_CANCELLED La limite de crédit de la boutique a été suspendue par Trusted Shops

-10003 DUPLICATE_ORDER_NUMBER Numéro de commande attribué plusieurs fois

-10004 UNSUPPORTED_TS_PRODUCT Produit Protection acheteurs non pris en charge

-10005 INACTIVE_PAYMENT_TYPE Mode de paiement inactif

-10006 UNSUPPORTED_PAYMENT_TYPE Mode de paiement non pris en charge

-10007 CURRENCY_MISMATCH La devise du produit Protection acheteurs ne correspond pas à la devise du panier

-10008 UNSUPPORTED_CURRENCY La devise n'est pas prise en charge dans cette boutique

-10009 UNSUPPORTED_EXCHANGE_RATE Le taux de change n'est pas pris en charge

-10010 NOT_PERSISTENT_PAYMENT_TYPE Le mode de paiement n'est pas pris en charge

-10011 NO_LIMIT Aucune limite de crédit existante pour ce certificat

-10012 PAST_DELIVERY_DATE La date de livraison se situe dans le passé

-10013 TOO_OLD_ORDER La garantie a été demandée pour un achat qui a plus de 3 jours

-10014 EMAIL_MALFORMED Le format de l'adresse électronique est incorrect

-10015 ORDER_ID_EMPTY Aucun numéro de commande n'a été transmis

-10016 CUSTOMER_ID_EMPTY Aucun numéro de client n'a été transmis



Fig. 3 : Exemple d'un bloc de texte Protection acheteurs Excellence

-10017 LIMIT_OVERFLOW La limite de crédit de ce certificat a été dépassée

-10018 EMAIL_EMPTY Aucune adresse électronique n'a été transmise

1.3.2 Exceptions SOAP typiques

Lors de la phase d'intégration et de fonctionnement, des exceptions SOAP peuvent survenir. Les erreurs d'exception typiques sont dues aux causes suivantes :

Erreur Cause

Invalid number of payload elements: 12 Error code: env:Server

Vérifier le nombre et l'ordre des paramètres transmis

java.lang.NumberFormatException Montant non valide

Date value does not follow the format ... Date non valide

String index out of range: 0 Date vide

1.3.3 Identifiants pour les environnements test

Lors de la phase d'intégration, utilisez les identifiants suivants pour les différentes langues. Vous

obtiendrez les identifiants pour l'environnement productif lors de la validation par votre interlocuteur

chez Trusted Shops.

Identifiants Webservice pour la langue FR :

ID Trusted Shops (tsID) : XB755CF51F0CA87DC01D509D3887D859C

Identifiant (wsUser) : testExcellencePartnerFR

Mot de passe (wsPassword) : test12345678

1.4 Intégration de la protection acheteurs dans le front-end de la boutique

1.4.1 Position de la boîte de dialogue Protection acheteurs Trusted Shops

La boîte de dialogue Protection acheteurs Excellence Trusted Shops est affichée de manière bien visible lors du choix du mode de paiement au cours du processus de vérification.

1.4.2 Textes de la boîte de dialogue Protection acheteurs Trusted Shops

Les textes suivants sont utilisés dans la boîte de dialogue Protection acheteurs pour la langue

concernée. Les indications en termes de taux de TVA sont toujours effectuées sans mentionner le

taux, c'est-à-dire par le biais de la formulation « TVA comprise » (ou « hors TVA » dans le cadre du

commerce B2B).

Textes nationaux pour la langue FR (veuillez remplacer le texte surligné en jaune) :

[ ] Protection acheteurs Trusted Shops (recommandée)



Protection acheteur jusqu'à 500 EUR (0,98 EUR TVA incluse) La protection acheteur Trusted Shops sécurise votre achat en ligne. J’accepte le transfert et la sauvegarde de mon adresse email pour le traitement de la protection acheteur par Trusted Shops. Conditions pour la protection acheteur.

1.4.3 Liens avec la boîte de dialogue de protection acheteurs

Le logo Trusted Shops ainsi que les termes surlignés sont reliés comme décrit ci-après,

indépendamment de la langue. Le paramètre shop_id correspond à l'ID Trusted Shops du certificat.

Pour les liens, veuillez utiliser le paramètre de lien target=“_blank“ qui ouvre la page dans une

nouvelle fenêtre du navigateur ou dans un nouvel onglet.

Lien sous forme d'URL du logo Trusted Shops (veuillez remplacer le texte surligné en

jaune)

https://www.trustedshops.com/shop/certificate.php?shop_id=shop_id

Lien sous forme d'URL « sauvegarde » (veuillez remplacer le texte surligné en jaune)

http://www.trustedshops.com/shop/data_privacy.php?shop_id=shop_id

Lien sous forme d'URL « conditions » (veuillez remplacer le texte surligné en jaune)

http://www.trustedshops.com/shop/protection_conditions.php?shop_id=shop_id

1.5 Trustbadge Trusted Shops avec Trustcard

Trusted Shops a développé une technologie d'intégration moderne et accrocheuse, permettant aux

membres Trusted Shops d’afficher clairement et visiblement leur fiabilité : le trustbadge.

Pour découvrir comment générer votre code trustbadge et l'intégrer sur votre site, veuillez vous

rendre sur http://www.trustedshops.fr/trustbadge.

Vous y trouverez également une fonction d'aperçu, grâce à laquelle vous pourrez visualiser votre site

avec les différentes versions du trustbadge.

Consignes d'intégration du trustbadge :

http://www.trustedshops.fr/trustbadge

Remarque:

La Trustcard ne peut s'afficher tant que votre certificat n'a pas été débloqué. Après cela, l'activation

de votre Trustcard peut prendre jusqu’à 24 heures.

2. Assistance

Pour toute question relative à l'intégration du label Trusted Shops avec protection acheteurs, veuillez

contacter :

Trusted Shops GmbH Service membres E-mail: [email protected]

http://www.trustedshops.com/shop/data_privacy.php?shop_id=shop_id

http://www.trustedshops.com/shop/protection_conditions.php?shop_id=shop_id

http://www.trustedshops.fr/trustbadge

mailto:[email protected]

Manuel d'intégration Trusted Shops

Documents

Transcript of Manuel d'intégration Trusted Shops