Demo_Payment

EXEMPLE D'IMPLEMENTATION DE LA SOLUTION DE PAIEMENT PAYZEN

FORMULAIRE DE PAIEMENT SIMPLE - LANGAGE PHP - HTML - Version du pack 1.0a

Formulaire de paiement | Analyse du retour

INFORMATION

Le paiement s'appuie sur l'envoi d'un formulaire de paiement en https vers l'URL de la plateforme de paiement PAYZEN. Veuillez trouver ci-dessous un exemple des différents champs. Ce code "index.php" envoie l'ensemble des champs liés au paiement vers le fichier "form_payment.php" qui récupère l'ensemble des ces champs pour les transmettre à la plateforme de paiement.

Les champs sont renseignés à titre d'exemple, à votre charge de les valoriser en fonction de votre contexte. Assurez vous que les droits sur le fichier count.txt soient configurés en lecture et en écriture pour un bon fonctionnement du script.

Afin que le script fonctionne correctement merci de renseigner le certificat de test ou de production selon le mode à la ligne 12 du fichier return_payment.php fourni dans ce pack.

D'autres champs sont disponibles, le support Payzen vous invite à lire la documentation liée au formulaire de paiement Consulter la documentation

CHAMPS DU FORMULAIRE DE PAIEMENT

Url de la plateforme de paiement: https://secure.payzen.eu/vads-payment/

En rouge les champs obligatoires

ACCES A LA PLATEFORME
vads_site_id		Identifiant Boutique à récupérer dans le Back office Payzen
Certificat		Certificat à récupérer dans le Back office Payzen. Attention ce certificat est différent en fonction du mode TEST ou PRODUCTION. Le certificat n'est pas envoyé à la plateforme de paiement mais intervient dans le calcul de la signature.
vads_ctx_mode		Mode de fonctionnement. Valeur = TEST ou PRODUCTION
vads_version		Ce paramètre est obligatoire et doit être valorisé à V2.
vads_language		Langue dans laquelle s'affiche la page de paiement.( fr pour Français , en pour Anglais . Plus d'info en consultant la documentation
PARAMETRES DE LA TRANSACTION
signature	WARNING	La signature est un paramètre obligatoire. Elle est calculée par la fonction Get_signature du fichier function.php inclu dans ce pack.
vads_trans_date	WARNING	Ce champ est obligatoire il correspond à la date de la transaction exprimée sous la forme AAAAMMJJHHMMSS sur le fuseau UTC=0. Cette valeur sera calculée par le fichier function.php.
vads_trans_id	WARNING	Ce champ est obligatoire il correspond à l'idententifiant de la transaction. Cet identifiant doit être: unique sur une même journée. sa longueur est obligatoirement de 6 caractères. Sa valeur est doit être comprise entre 000000 et 899999 DANS CET EXEMPLE LE CALCUL DE CE CHAMP EST FAIT PAR LE FICHIER "function.php" et s'appuie sur un compteur. VOUS POUVEZ CALCULER CE CHAMP A VOTRE CONVENANCE EN RESPECTANT LES REGLES DU CHAMP TRANS_ID.
vads_currency		Code devise 978 pour EURO.Plus d'info en consultant la documentation
vads_amount		Montant de la commande exprimé dans la plus petite unité de la devise. Centimes pour EURO Ex :1000 pour 10 euros
vads_page_action		Ce paramètre est obligatoire et doit être valorisé à PAYMENT.
vads_action_mode		Ce paramètre est valorisé à INTERACTIVE si la saisie de carte est réalisée sur la plateforme de paiement. Plus d'info en consultant la documentation
vads_payment_config		Ce paramètre est valorisé à SINGLE pour un paiement unitaire.
vads_capture_delay		Ce paramètre défini le délai de remise en banque en nombre de jour. Passé à vide la plateforme de paiement prend comme valeur par défaut la valeur défini dans le back office "outil de gestion de caisse.
PARAMETRES CLIENT
vads_order_id		Numéro de commande. Paramètre facultatif. Longueur du champ 32 caractères maximum - Type Alpha numérique
vads_cust_id		Numéro client. Paramètre facultatif. Longueur du champ 32 caractères maximum - Type Alpha numérique
vads_cust_name		Nom du client. Paramètre facultatif. Longueur du champ 127 caractères maximum - Type Alpha numérique
vads_cust_address		Adresse du client. Paramètre facultatif. Longueur du champ 255 caractères maximum - Type Alpha numérique
vads_cust_zip		Code Postal du client. Paramètre facultatif. Longueur du champ 32 caractères maximum - Type Alpha numérique
vads_cust_city		Ville du client. Paramètre facultatif. Longueur du champ 63 caractères maximum - Type Alpha numérique
vads_cust_country		Pays du client. Code pays du client à la norme ISO 3166. Paramètre facultatif. Longueur du champ 2 caractères maximum - Type Alpha.
vads_cust_phone		Téléphone du client. Paramètre facultatif. Longueur du champ 32 caractères maximum - Type Alpha numérique
vads_cust_email		Email du client. Paramètre facultatif.
RETOUR A LA BOUTIQUE
vads_url_return		Url de retour à la boutique. Lorsque le client clique sur "retourner à la boutique". Cette url permet de faire un traitement affichage en indiquant l'état du paiement. Il est fortement conseillé de ne pas faire de traitement en base de données (mise à jour commande, enregistrement commande) suite à l'analyse du résultat du paiement. C'est l'appel de l'url serveur qui doit vous permettre de mettre à jour la base de données.
vads_return_mode		Ce paramètre définit dans quel mode seront renvoyés les paramètres lors du retour à la boutique (3 valeurs possibles GET / POST / NONE). Si ce champ n'est pas posté alors la plateforme ne renvoie aucun paramètre lors du retour à la boutique par l'internaute.
vads_redirect_success_timeout		Ce paramètre définit la durée avant un retour automatique à la boutique pour un paiement accepté(valeur exprimée en seconde).
vads_redirect_success_message		Ce paramètre définit un message sur la page de paiement avant le retour automatique à la boutique dans le cas d'un paiement accepté.
vads_redirect_error_timeout		Ce paramètre définit la durée avant un retour automatique à la boutique pour un paiement échoué(valeur exprimée en seconde).
vads_redirect_error_message		Ce paramètre définit un message sur la page de paiement avant le retour automatique à la boutique dans le cas d'un paiement échoué.
URL SERVEUR => A PARAMETRER DANS LE BACK OFFICE PAYZEN
L'url serveur est une URL qui doit être renseignée dans le back office PAYZEN. Cette url est systematiquement appelée à la fin d'un paiement par la plateforme PAYZEN. Lors de cet appel la plateforme de paiement PAYZEN renvoie en mode POST l'ensemble des champs nécessaires à l'analyse du paiement ( paiement accepté ou paiement refusé ). Cet appel est indépendant du retour ou non de l'internaute vers la boutique.Cet appel doit vous permettre de mettre à jour votre systeme d'information. Dans le cas où la plateforme n'arrive pas à joindre l'url serveur, vous recevrez automatiquement un mail vous indiquant le paiement concerné, vous pourrez alors analyser la raison de l'échec ( erreur http XXX ) et rejouer l'url serveur depuis le back office PAYZEN en cliquant sur la transaction et en sélectionnant "exécuter l'url serveur". Dans ce pack vous pouvez faire pointer à titre d'exemple l'url serveur vers le fichier return_payment.php.