Introduction

Il existe deux types d'interactions entre un système lutèce et Paybox :

1. La redirection d'un usager vers le système paybox.
2. la récupération des informations de paiement.

Ces deux cas d'utilisation sont expliqués dans la suite de cette page.

Avant d'aller plus en avant dans ce document il est conseillé de lire les documents ManuelIntegrationPayboxSystem_V5.08_FR.pdf et ParametresTestPaybox_V5.08_FR.pdf en version 5.8 téléchargeable sur la page de documentation de Paybox .

Redirection de l’usager vers les serveurs Paybox

Dans cas le plus courrant, donc sans aucune personnalisation, seul trois informations sont requises une fois les configurations finalisées :

• Un montant à payer en centimes.
• Une référence de dossier.
• Le mail de l'usager.

// Paiement de 100 € pour la référence de commande 33, le mail de l’usager est usager@isp.tld
String monUrl = PayboxUtil.buildPayboxUrl( 10000L, "33", "usager@isp.tld" );

Pour les cas les plus complexe il faut utiliser la méthode

public static String buildPayboxUrl( final String url, final LinkedHashMap<String, String> params )

Récupéation des informations de paiement

Une fois le paiement effectué par l'usager Paybox effectue une requete HTTP sur une url paramétrable.
La méthode checkSignature effectue le contrôle de la signature, il suffit de lui passer la chaine de caractères des paramètres reçu par la requête.
La valeur true est retournée si la signature est vérifiée.

// HttpServletRequest request
PayboxUtil.checkSignature( request.getQueryString( ) )