JHotelReservation

thumb hotelreservation payzen Ce tutorial s’adresse à tous les marchands ayant souscrit à l’offre PayZen et s’appuyant sur la plateforme Joomla et le composant JHotelReservation.

Obtenir le plugin

Fonctionnalités

Le module de paiement propose les fonctionnalités suivantes :

  • Compatible multi langue
  • Paiement comptant
  • Paiement en plusieurs fois
  • Paiement en plusieurs fois avec échéancier personnalisé
  • Redirection automatique à la boutique à la fin du paiement
  • Enregistrement systématique des réservations à la fin du paiement via une url silencieuse (url de notification)

Prérequis

Avant de procéder à l’intégration du module de paiement, veuillez-vous assurer d’être en possession des éléments suivants :

  • Identifiant de votre boutique
  • Certificat de test ou de production

L'identifiant de la boutique ainsi que les certificats sont disponibles sur le Back Office PayZen (Menu : Paramétrage > Boutique > Certificats )

Installation du paiement

Creation d'un paiement

Dans l'administration de JHotelReservation, cliquez sur Processeurs de paiement, puis sur le bouton nouveau.

  1. Entrer un Nom pour votre paiement: c'est celui qui apparaitra sur la page de paiement lors du paiement de la reservation.
  2. Le champ Type doit être :
    • AlatakPayzen pour un paiement comptant
    • AlatakPayzenMulti pour un paiement en plusieurs fois avec échéancier fixe
    • AlatakPayzenMultiExt pour un paiement en plusieurs fois avec échéancier personnalisé
  3. Préciser le Mode : il permet d'indiquer le mode de fonctionnement du module (Test ou En direct) Le mode En direct ou en PRODUCTION n'est disponible qu'après avoir réalisé la phase de test. Le mode TEST est toujours disponible.
  4. Mettre Actif pour le Statut
  5. Péciser le groupe pour lequel ce paiement est disponible.
  6. Ajouter ensuite les paramètres spécifique a votre paiement.

jhotelreservation payzen paiment 1fois

Paramètres obligatoires des paiements

NomDéfinitionExplication
site_id Identifiant de la boutique Indiquez l’identifiant boutique sur 8 chiffres, disponible sur votre Back Office (Menu: Paramétrage > Boutiques > Certificats)
key_test Certificat en mode test Indiquez le certificat de test disponible depuis votre Back Office (Menu: Paramétrage > Boutiques > Certificats).
key_prod Certificat en mode production: Indiquez le certificat de production disponible dans votre Back Office (Menu: Paramétrage > Boutiques > Certificats). Attention ce certificat de production n’est disponible qu'après avoir réalisé la phase de test.
single_multi Paiement comptant ou en plusieurs fois
  • SINGLE pour le paiement comptant
  • MULTI en plusieurs fois
  • MULTI_EXT pour un paiement en plusieurs fois avec échéancier personnalisé

Paramètres pour les paiements comptant ou/et en plusieurs fois (échéancier fixe ou personnalisé)

NomDéfinitionExplicationValeur par défaut 
3ds_min_amount Montant minimum pour activer 3DS Montant minimum pour lequel vous souhaitez demander une authentification 3-D Secure.
ATTENTION :
La valeur de ce champ sera prise en compte uniquement si l’option ‘3D-Secure sélectif’ est activée sur votre boutique PayZen. Cette option ne peut être activée qu’après accord préalable de votre banque.
 
platform_url URL de la page de paiement https://secure.payzen.eu/vads-payment/  
language Langues par défaut Cette option permet de choisir la langue de la page de paiement par défaut dans le cas où la langue ne serait pas connue par PayZen fr
available_languages Langues disponibles

Permet de personnaliser l'affichage des langues sur la page de paiement.

L'acheteur pourra ainsi changer de langue lorsqu'il sera redirigé sur la page de paiement.
Langues disponibles : Français, allemand, anglais, espagnol, chinois, italien, japonais, portugais, néerlandais, suédois, russe

Toutes
capture_delay Délai avant remise  Par défaut ce paramètre est géré dans votre Back Office. (Menu : Paramétrage > Boutiques > Configuration – rubrique : délai de capture)
Il est conseillé de ne pas renseigner ce paramètre.
 
validation_mode Mode de validation

 par défaut Configuration Back Office : Valeur conseillée. Permet d’utiliser la configuration définie dans le Back Office. (Menu : Paramétrage Boutiques > Configuration – rubrique : mode de validation)

0 pour Manuelle : Cette valeur indique que les transactions devront faire l'objet d'une validation manuelle de la part du commerçant depuis le Back Office. Attention : sans validation par le commerçant avant la date d’expiration, la transaction ne sera jamais remise en banque .

1 pour Automatique : Cette valeur indique que le paiement sera remis en banque de manière automatique sans l’intervention du commerçant.

Configuration Back Office
payment_cards Types de cartes

Ce champ permet d’indiquer les visuels des cartes à afficher sur la page de paiement ou sur le site marchand (cf. « entrée des données cartes »).

Attention : Les types de paiement proposés à l'acheteur sur la page de paiement dépendent des contrats et des options associés à votre offre PayZen.

Toutes
redirect_enabled Redirection automatique

Cette option permet de rediriger de manière automatique l'acheteur vers le site marchand.

Cette option dépend du paramétrage qui suit. Elle peut avoir les valeur yes ou no.

no
redirect_success_timeout Temps avant redirection (succès) Dans le cas où l’option redirection automatique est activée, vous pouvez définir le délai en secondes avant que votre client soit redirigé vers votre boutique dans le cas d’un paiement réussi. 5
redirect_success_message Message avant redirection (succès) Dans le cas où l’option redirection automatique est activée vous pouvez définir le message inscrit sur la plateforme suite à un paiement réussi avant que votre client soit redirigé vers la boutique. Redirection vers la boutique dans quelques instants
redirect_error_timeout Temps avant redirection (échec) Dans le cas où l’option redirection automatique est activée, vous pouvez définir le délai en seconde avant que votre client soit redirigé vers votre boutique, dans le cas d’un paiement échoué.  5
redirect_error_message Message avant redirection (échec) vous pouvez définir le message inscrit sur la plateforme suite à un échec de paiement avant que votre client soit redirigé vers la boutique. Redirection vers la boutique dans quelques instants

Paramètres spécifiques au paiement en plusieurs fois (échéancier fixe)

NomDéfinitionExplication
amount_min Montant minimum Ce paramètre défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Si ce paramètre est préciser, le moyen de paiement ne sera pas proposé pour tous les utilisateurs qui possèdent une réservation avec un montant inférieur.
amount_max Montant maximum Ce paramètre défini le montant maximum au-delà duquel vous ne souhaitez pas proposer cette méthode de paiement. En définissant un montant maximum, le moyen de paiement ne sera pas proposé pour tous les utilisateurs qui possèdent une réservation avec un montant supérieur.
count Nombre Nombre d’échéances d’un paiement: 3 pour du paiement en 3 fois 4 pour du paiement en 4 fois Etc...
period Période Période (en jours) entre chaque échéance.
first Premier paiement Montant de la première échéance, en pourcentage du montant.
Exemple : Pour un montant de 100 euros en 3 fois, vous pouvez fixer le pourcentage du premier paiement à 50% du montant. Cela signifie donc que le montant de la première échéance sera de 50 euros et que les deux autres seront de 25 euros .
Pour 50% saisir 50.
Si vous souhaitez des montants identiques pour chaque échéances, laissez le champ vide.

jhotelreservation payzen paiment liste

Paramètres spécifiques au paiement en plusieurs fois (échéancier personnalisé)

NomDéfinitionExplication
datei

Date de la énième échéance

Date de la énième échéance.

La valeur i doit avoir la valeur 1 pour la première échéance, 2 pour la deuxième, etc ...
La syntaxe est la suivante:

  • today,+x: l'echéance est x jour après la date du jour. x peut avoir la valeur 0 pour indiquer la date du jour.
  • start_date,+x: l'echéance est x jour après la date de début de la réservation
  • start_date,-x: l'echéance est x jour avant la date de début de la réservation
amounti Montant de la énième échéance

Montant de la énième échéance, en pourcentage du montant.

Pour 50% saisir 50.

Note: l'ensemble des montants doit être égal à  100.
 

Si la date d'une des echéances est antérieure à la date du jour, le paiement est converti en paiement comptant.

Paramètrage de l'URL de notification à la fin du paiement

Dans votre Back Office PayZen, vous devez paramétrer une URL qui sera systématiquement appelée après un paiement. Elle informera le site marchand du résultat du paiement.

Ce paramètre s’appelle URL de notification à la fin du paiement.

Il est indispensable que cette URL soit renseignée, sinon le paiement ne se mettra jamais à jour dans JHotelReservation

Pour accéder à la gestion des règles de notification :

  1. Connectez-vous au back office de payzen
  2. Allez dans le menu : Paramétrage > Règles de notifications

    payzen url notification

  3. Effectuez un clic droit sur la ligne URL de notification à la fin du paiement
  4. Sélectionnez Gérer la règle
  5. Renseignez dans les champs URL à appeler en mode TEST et URL à appeler en mode PRODUCTION l'URL :
    votresiteweb.com/index.php?option=com_jhotelreservation&task=paymentoptions.processAutomaticResponse&processor=alatakpayzen

    payzen url paiment regle

Personnalisation de l'affichage des modes de paiements

Sur le site, tous les paiements affichent un logo. Pour le personnaliser, modifiez les images du repertoire suivant

components/com_jhotelreservation/assets/img/payment/alatakpayzen.gif
components/com_jhotelreservation/assets/img/payment/alatakpayzenmulti.gif
components/com_jhotelreservation/assets/img/payment/alatakpayzenmultiext.gif

 

jhotel reservation personnalisaation

Test de l'URL de notification

Pour valider le fonctionnement de l’URL de notification, suivez les étapes ci-dessous:

  1. Vérifiez que votre url soit accessible depuis l’extérieur: votre site ne doit pas être en mode maintenance ni protégée par un fichier .htaccess,
  2. Assurez-vous que l’option "retour automatique" soit désactivée dans les paramètres du module,
  3. Vérifiez que l’URL de notification à la fin du paiement soit bien renseignée dans le Back Office PayZen(cf. ci-dessus),
  4. Réalisez une réservation sur votre site et procédez au paiement,
  5. Vérifiez dans le menu Réservation , que la colonne "Paiement" est bien a Payé. 

jhotelreservation payzen paye