WL SIPS DOCS

Release 22.6

aller directement au contenu

Rechercher par mots clés

Validation

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

La fonction de validation permet de déclencher la remise en paiement d’une transaction. Elle vous permet ainsi de faire du paiement différé en débitant votre client à l’expédition des produits achetés.

En choisissant le mode validation (captureMode = VALIDATION), il est nécessaire de valider chacune des transactions pour les envoyer en paiement. Si vous ne validez pas une transaction donnée avant que son délai de capture choisi ne prenne fin, cette transaction expirera. Il sera alors impossible de l'envoyer en paiement. Si vous omettez de valider dans les délais, vous pourrez représenter la transaction grâce à l’opération de duplication.

Vous pouvez valider tout ou partie du montant de la transaction. Le montant validé partira en paiement le jour de sa validation. Il est impossible de valider un montant supérieur au montant d’origine de la transaction. Vous ne pouvez valider une transaction qu’une seule fois. Dans le cas d’un paiement partiel, le complément peut être réalisé grâce à l’opération de duplication.

Lorsque vous validez une transaction en totalité, elle passe du status TO_VALIDATE au status TO_CAPTURE. Si vous ne la validez que partiellement, elle reste en status TO_VALIDATE.

Table 1. En résumé
Connecteurs disponibles Sips Office, Sips Office Batch, Sips Office Extranet
Configuration WL Sips OUI VALIDATE
Vérification acquéreur NON
Reporting

  • Journal des transactions : NON
  • Journal des opérations : OUI, VALIDATE
  • Sips Office Extranet : OUI

Votre métier de vente sur Internet vous a peut-être contraint à implémenter vos paiements en mode validation (champ captureMode = VALIDATION), et à envoyer une requête de validation via Sips Office immédiatement après le paiement, soit au retour de votre client sur votre site marchand, soit à réception de la réponse automatique. Ce mode de fonctionnement est valable, mais vous devez prendre quelques précautions de mise en œuvre et échanger avec votre chargé de compte pour qu'il(elle) valide votre choix.

Afin d'optimiser la réussite de vos ventes sur Internet, nous utilisons un système d'écriture en base de données de type asynchrone. Grâce à ce système d'écriture asynchrone, nous restons en capacité d'accepter vos transactions de paiement en temps réel, même si notre système base de données venait à subir quelques perturbations ou à ralentir.

Toutefois, lors d'une maintenance ou en cas d'engorgement ponctuel de notre système de base de données, les transactions s'enregistrent avec un temps de décalage par rapport au traitement temps réel du paiement. Il est par conséquent nécessaire de suivre les conseils ci-dessous pour votre implémentation de validations automatisées .

Code réponse Description Causes possibles Conseils de mise en oeuvre
00 La validation est acceptée RAS RAS
25 Validation refusée, car la transaction n'est pas trouvée en base de données Cas 1 : vous avez commis une erreur dans la requête. Les données d'identification de la transaction (transactionReference ou transactionId ou transactionDate) sont fausses, ou vous tentez de valider un paiement qui ne s'est pas terminé (par exemple l'acheteur a abandonné)

Cas 2 : la transaction de paiement a bien été traitée jusqu'à sa fin , mais elle n'est pas encore enregistrée en base de données, dû à notre système asynchrone d'écriture en base de données Nous conseillons de mettre en place un batch de recyclage automatique de ces tentatives de validation échouée, et d'exécuter ce batch 30 minutes minimum après le paiement, de manière à laisser le temps nécessaire d'insertion de la transaction en base de données. Si vous recevez un nouveau code 25, nous ne sommes pas dans le cas 2, mais certainement dans le cas 1 décrit ci-contre

99 Validation échouée, car notre système de gestion de caisse est ponctuellement inaccessible Cas 1 : nous subissons un incident technique, nous mettons tout en œuvre pour rétablir la situation au plus tôt. Vous allez recevoir une communication par e-mail décrivant l'incident.

Nous conseillons de mettre en place un batch de recyclage automatique de ces tentatives de validation échouée, et d'exécuter ce batch 30 minutes minimum après le paiement, de manière à laisser le temps nécessaire au rétablissement du service. Tant que vous recevez un code 99, recyclez votre requête de validation.
Cas 2 : nous sommes en maintenance. S'il s'agit d'une maintenance programmée, un e-mail vous a été transmis quelques semaines auparavant.

Pour valider une transaction via Sips Office, utilisez la méthode validate.

Pour valider une transaction via Sips Office Batch, utilisez la méthode validate.

Découvrez comment valider une transaction en vidéo ou en suivant les explications ci-dessous :

Cliquez sur l'onglet transactions.

La page suivante s'affiche :


page de critères de recherche

Vous pouvez filtrer les transactions validables dans l'outil de recherche de Sips Office Extranet. Sélectionnez l'état de la transaction "A valider" :

Les résultats de la recherche s'affichent :



Cliquez sur le bouton de validation à côté de la transaction que vous voulez valider dans la liste des résultats.

Note:

Vous pouvez également valider une transaction depuis la page de détails de la transaction en cliquant sur le bouton validation.

La page suivante s'affiche :


données de la transaction à valider: référence, identifiant, date, etc

Saisissez le montant à valider. Cliquez sur valider transaction.

La page suivante s'affiche alors en cas de validation réussie :


résumé de la transaction d'origine et du résultat de la validation de la transaction

Si la validation a échoué, la page suivante s'affiche :


un message apparait indiquant que la validation refusée

Lorsque vous faîtes une validation via Sips Office et Sips Office Batch, vous pouvez rencontrer les responseCode d'erreur suivants :

responseCode définition
24 La transaction n'est pas dans le bon status (TO_VALIDATE).

Ou une autre opération de gestion de caisse est en cours sur cette transaction.

25 La transaction n'existe pas dans la base de données WL Sips.
40 Vous ne disposez pas du droit de valider les transactions.
51 Le montant à valider est supérieur au montant de la transaction initiale.

Vous pouvez voir l'intégralité des codes réponses possibles sur la page dédiée aux codes réponses.

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres