Contenu
Plus d'information
Implémentation sur les appels WebService DirectPaymentAPI et WebPaymentAPI
Il est possible et 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 plusieurs 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
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.
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.
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.