La durée d'autorisation maximale pour une transaction PayPal est de 29 jours. Après ce délai, la transaction est expirée. À noter que pour un délai de capture supérieur à 6 jours, les fonds ne sont pas bloqués et la transaction pourra être refusée. En cas de refus, nous vous invitons à examiner le code réponse transmis par PayPal.

La vérification de paiement est une fonctionnalité de PayPal. Elle identifie les transactions à risque et vous informe afin de mettre en attente les expéditions jusqu'à ce que PayPal ait évalué le risque de la transaction.

Si un paiement est en cours de vérification par PayPal, ou nous n'avons pas reçu le retour de Paypal escompté (timeout) l'état de la transaction est :

• TO_CONFIRM_AUTHOR (vérification du paiement à l'étape d'autorisation) ;
• TO_CONFIRM_CAPTURE (vérification du paiement à l’étape de la remise).

Un traitement par fichier est exécuté quotidiennement pour mettre à jour ces transactions vers des états finaux :

• REFUSED (si le paiement a été refusé) ;
• TO_CAPTURE/TO_VALIDATE (si l'autorisation a été approuvée) ;
• CAPTURED (si la remise a été effectuée).

Le diagramme du paragraphe Effectuer un paiement PayPal schématise ces états ainsi que les transitions.

Le statut final apparaîtra dans vos journaux des transactions pour vous permettre de continuer le traitement de la commande.

Sherlock's permet d'envoyer à PayPal des informations sur le panier d'achat.

PayPal valide les montants en appliquant les règles suivantes :

• Amount=ShoppingCart.TotalAmount+ShoppingCart.TotalTaxAmount+Delivery.ChargeAmount ;
• ShoppingCartDetail.TotalAmount = ∑items item.UnitAmount∗item.Quantity ;
• ShoppingCartDetail.TotalTaxAmount = ∑items item.UnitTaxAmount∗item.Quantity.

Si la validation d'une des trois règles échoue, le paiement est abandonné par PayPal. Le code réponse Sherlock's et le code réponse acquéreur auront comme valeur « 12 » (Invalid Request).  

PayPal affiche l'adresse de livraison sur ses pages de paiement. L'adresse de livraison peut être récupérée à partir de deux sources différentes :

• depuis le compte PayPal du client ;
• depuis les requêtes de paiement que vous transmettez à Sherlock's.

La sélection est effectuée par le biais du champ paymentMeanData.paypal.addrOverride :

• la valeur NO_OVERRIDE sélectionne l'adresse de livraison spécifiée dans le compte PayPal du client ;
• la valeur OVERRIDE sélectionne l'adresse de livraison spécifiée dans la requête de paiement. Si aucune adresse n’est fournie dans la requête alors l’adresse du compte est affichée (valeur par défaut) ;
• la valeur NO_DISPLAY n'affiche pas l'adresse de livraison.

Les champs suivants ont un comportement particulier :

Le tableau suivant récapitule les différents cas de réponse à traiter :

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Lors d’un refus, PayPal détermine si le client peut utiliser un autre moyen de paiement enregistré sur son compte. Si c’est le cas, PayPal transmet une information particulière qui permet à Sherlock's de rediriger à nouveau le client vers PayPal pour effectuer une nouvelle tentative.

Cette fonctionnalité vous permet d’augmenter votre taux de conversion dans le cas d'un paiement refusé car elle évite que le client revienne sur votre site Web puis relance à nouveau tout le processus de paiement.  

L’initialisation d’un paiement PayPal est effectuée en appelant la méthode paymentProviderInitialize.

Le client doit être redirigé vers l’URL « redirectionUrl » fournie en réponse de la méthode « paymentProviderInitialize ». Cette redirection consiste à effectuer un appel POST sur l’URL « redirectionUrl » obtenue dans la réponse à l’initialisation de paiement.

A la fin de la cinématique de paiement, le client est redirigé sur l’URL fournie dans la requête d’initialisation, « merchantReturnUrl ». Les champs suivants sont transmis en POST et doivent être récupérés pour finaliser le paiement :

Cette dernière étape vous permet d’obtenir le statut du paiement. Les paramètres obtenus lors de la redirection après la cinématique de paiement sur le site Web PayPal sont à transmettre lors de cet appel. La méthode utilisée pour finaliser un paiement est paymentProviderFinalize.

La méthode paymentProviderGetContext est optionnelle et vous permet de récupérer des informations concernant le client et le paiement en cours. La requête est directement soumise à PayPal et permet notamment d’obtenir des informations sur l’adresse de livraison, l’e-mail de l’acheteur ou encore le statut du paiement chez PayPal.

Cette méthode doit être appelée après la redirection de l’acheteur de la page PayPal vers le site du marchand et avant la finalisation d’un paiement. Si elle est appelée après la finalisation, PayPal peut refuser la restitution d’informations.

Pour marquer la transaction comme éligible à la duplication, vous devez l'indiquer comme telle dans le message de création envoyée à Sherlock's donnant au champ paymentMeanData.PayPal.dupFlag la valeur « true ».

Le champ dupDesc est facultatif et n'est utilisé que si le champ dupFlag a pour valeur « true ».

Ce champ est utilisé pour ajouter une description au processus de duplication. La description sera affichée sur la page de détails du paiement PayPal.

Le champ dupType est facultatif et n'est utilisé que si le champ dupFlag a pour valeur « true ».

Les valeurs acceptées sont :

• ANY : vous acceptez n'importe quel moyen de paiement pour l'accord de facturation, même si le mouvement des fonds vers votre compte peut prendre quelques jours. Cela inclut les chèques, en plus des cartes de crédit et de débit, et du solde PayPal.
• INSTANTONLY : les moyens de paiement que vous acceptez sont limités aux cartes de crédit et de débit ainsi qu'au solde PayPal (vous forcez un paiement immédiat).

Le champ dupCustom est facultatif et n'est utilisé que si le champ dupFlag a pour valeur « true ».

Ce champ est un champ d'annotation personnalisé qui vous est réservé, il est affiché sur le détail de vos transactions dans votre back-office PayPal.