Intégration API DirectPayment
Cinématique de bascule
Cette procédure vous permet d'éviter une boucle sans fin de bascule :
Sélection du premier endpoint.
Appel du service et vérification du résultat :Si l'appel est réalisé avec succès alors fin de la procédure. Implémentation sur les appels WebService DirectPaymentAPI et WebPaymentAPI
Il est recommandé d'utiliser la bascule à la source au niveau des appels WebService effectués entre le backend marchand et l'API WebService Payline.
Pour implémenter ce mécanisme, il faut :
- mettre à jour la version du kit java/php/.net avec celle supportant la bascule à la source
- ou effectuer les développements sur le backend marchand si les kit fournis par Payline ne sont pas utilisés sur votre système.
Ci-dessous les détails des explications sur la manière de l'implémenter côté serveur marchand (utilisation du service d'annuaire, ajout d'en-tête http, cas de bascule, ...)
Cinématique de bascule
Diagramme draw.io |
---|
border | true |
---|
| |
---|
diagramName | bascule_source_process_ws |
---|
simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth | 896 |
---|
revision | 4 |
---|
|
Si l'appel est en erreur :
Conditions de bascule non respectées alors fin de la procédure. Conditions de bascule respectées : - Vérification si tous les endpoints sont en erreurs ?
- oui alors fin de la procédure.
- non alors sélection du endpoint suivant et retour à l'étape 2.
Avertissement |
---|
title | Attention - Appels à l'annuaire |
---|
|
Pour des raisons de performance, la mise à jour des URLs doit respecter le ttl (Time To Live) indiqués (il est en seconde.) En aucun cas cet annuaire ne doit être sollicité à chaque appel WebService/REST. |
Avertissement |
---|
title | Attention - En cas d'indisponibilité de l'annuaire |
---|
|
Si l'appel à l'annuaire est en échec et/ou qu'une liste vide est retournée, ne pas supprimer les URL présentes côté serveur client et les conserver jusqu'au prochain appel en succès. Ceci afin d'éviter qu'en cas d'échec ou d'incident sur le service d'annuaire, tous les appels webservices soient en échec. |
Info |
---|
title | Attention - Nouvelles URL à contacter depuis vos serveurs et applications |
---|
|
En cas de restriction sur les URL joignables depuis vos applications/serveurs, des ouvertures vers de nouvelles URL sont à effectuer sur votre infrastructure. Voici le tableau récapitulatif :
|
Info |
---|
title | Conseil - Listes de codes retours |
---|
|
Les deux listes de codes retours http et de codes retours métier doivent pouvoir être paramétrables côté client. Elles pourraient être enrichies lors d'évolutions futures. |