IV - LANCEMENT DU MODULEV2.CGI. PAYBOX Services

- Les ports TCP à autoriser au niveau de votre architecture sont 80 (http), 443 (HTTPS) et 53

(DNS).

Une fois installé, le module doit pouvoir s’exécuter directement à travers l’adresse Internet sur votre navigateur (par exemple :

http://www.maboutique.com/cgi-bin/modulev2.cgi

).

A l’exécution, vous devriez avoir un message du type « paybox input error code (-7) » ou

« paybox input error code (-3) » : cela signifie que le module s’est bien exécuté (l’erreur étant seulement dû à l’absence des variables à référencer).Pour tout type d’erreur du style :

- internal server error,

- impossible d’afficher la page,

- erreur 404 : not found,

- bug in dynamic linker,

- le fichier spécifié est introuvable,

- CGIWrap Error: Script Execution Failed,

- et autres… il vous faut vérifier tous les points précédents.

I

I

V

-

L A N C E M E N T D U M O D U L E V

2

.

.

C G I

I

:

:

Une fois le module installé, il vous faut l’exécuter à partir de la page de votre site qui précède la page de paiement Paybox System. Le lancement du module devra être accompagné de différentes variables, l’exécution pouvant être effectuée sous différents modes.

Il n’y a aucune restriction sur le langage utilisé pour l’appel de ce module : vous pouvez sans souci utiliser l’HTML, l’ASP, le PHP, le PERL… a

-

L e s d i i f f f f é r r e n t t e s v a r r i i a b l l e s

:

:

Pour pouvoir assurer un paiement sur le serveur PAYBOX, le « modulev2.cgi » a besoin de récupérer les informations nécessaires à la réalisation du paiement et à la gestion des liens entre l’acheteur, le commerçant et le site « PAYBOX SERVICES ». Ces données sont stockées dans les variables suivantes (dont le nom est fixe et en majuscule) : n o m v a r r i i a b l l e e d e e s s c c r r i i p t t i i o n t t a i i l l l l e e t t y p e e v e e r r s s i i o n m o d u d u u l l e e

PBX_MODE

Mode de récupération des informations. de 1 à 4 chiffres parmi les valeurs 1,2,3 ou 4.

1 à 4 chiffres. obligatoire >= 2.00

PBX_SITE Numéro de site (TPE) donné par la banque [voir page 42]. 7 chiffres. obligatoire >= 2.00

PBX_RANG

Numéro de rang (« machine ») donné par la banque [voir page

42].

2 chiffres. obligatoire >= 2.00

___________________________________________________________________________________________

PAYBOX SERVICES.

Centre Espace Sud – Route d’Elne - 66200 LATOUR BAS ELNE tél : 04.68.85.79.90 -fax : 04.68.85.79.99

Version 3.41 Page 6 sur 44

PBX_TOTAL

PBX_DEVISE

PBX_CMD

PBX_PORTEUR

PBX_RETOUR

PBX_IDENTIFIANT

PBX_EFFECTUE

PBX_REFUSE

PBX_ANNULE

PBX_OPT

PBX_TXT

PBX_WAIT

PBX_BOUTPI

PBX_BKGD

Montant total de l’achat en centimes sans virgule ni point.

1 à 10 chiffres.

Code monnaie de la transaction suivant la norme ISO 4217 (code numérique) :

Par exemple :

« 978 » pour l’euro.

« 840 » pour le dollar US.

« 952 » pour le CFA.

3 chiffres. obligatoire >= 2.00

Votre référence commande.

1 à 250 caractères. obligatoire >= 2.00

Adresse email de l’acheteur (porteur de carte).

Les caractères @ et . doivent être présents.

6 à 80 caractères.

Variables renvoyées par Paybox (montant, référence commande, numéro de transaction, numéro d’abonnement et numéro d’autorisation) [voir page 14].

3 à 150 caractères. obligatoire >= 2.00 obligatoire >= 2.00 obligatoire >= 2.00

Identifiant PAYBOX fourni par PAYBOX SERVICES au moment de votre inscription.

1 à 9 chiffres obligatoire >= 2.00

Page de retour de Paybox vers votre site après paiement accepté

[voir page 13]. jusqu’à 150 caractères. facultatif

Page de retour de Paybox vers votre site après paiement refusé

[voir page 13]. jusqu’à 150 caractères. facultatif

>= 2.00

>= 2.00

Page de retour de Paybox vers votre site après paiement annulé

[voir page 13]. jusqu’à 150 caractères. facultatif

Nom du fichier local quand la variable PBX_MODE est documentée avec la valeur « 3 » [voir page 10].

Texte pouvant être affiché sur la page intermédiaire à la place du texte par défaut [voir page 21]. jusqu’à 150 caractères. facultatif non limité. facultatif

>= 2.00

>= 2.00

>= 2.00

Délai d’affichage de la page intermédiaire. La valeur est en milli-secondes [voir page 21].

Intitulé du bouton de la page intermédiaire (« nul » pour la suppression de ce bouton) [voir page 21].

Fond d’écran de la page intermédiaire (nom de couleur, code couleur ou image) [voir page 21]. jusqu’à 5 chiffres. facultatif jusqu’à 50 caractères. facultatif jusqu’à 150 caractères. facultatif

>= 2.00

>= 2.00

>= 2.00

PBX_OUTPUT

PBX_LANGUE

PBX_ERREUR

PBX_PAYBOX

PBX_SOURCE

Mode de gestion de la page intermédiaire. Les valeurs possibles sont : A, B, C, D et E [voir page 21].

Langue utilisée par Paybox pour l’affichage de la page de paiement. Par défaut, la page est en français. Les valeurs possibles sont FRA (Français), GBR (Anglais), ESP (Espagnol),

ITA (Italien), DEU (Allemand), NLD (Hollandais) et SWE

(Suédois).

URL de votre site permettant d’afficher la description des

éventuelles erreurs pouvant survenir à l’affichage de la page de paiement [voir page 23].

URL du serveur de paiement primaire de Paybox si différente de celle par défaut :

https://tpeweb.paybox.com/cgi/MYchoix_pagepaiement.cgi

Type de navigateur internet :

??

HTML : valeur par défaut

1 caractère. facultatif >= 2.00

3 caractères. facultatif jusqu’à 150 caractères.

3 à 5 caractères facultatif jusqu’à 150 caractères. facultatif facultatif

>= 2.00

>= 2.00

>= 2.00

>= 2.00

___________________________________________________________________________________________

PAYBOX SERVICES.

Centre Espace Sud – Route d’Elne - 66200 LATOUR BAS ELNE tél : 04.68.85.79.90 -fax : 04.68.85.79.99

Version 3.41 Page 7 sur 44

PBX_BACKUP1

PBX_BACKUP2

PBX_BACKUP3

PBX_BACKUP4

??

WAP : création d’une page de paiement au format

WML

??

IMODE : création d’une page de paiement au format iHTML

URL du serveur de paiement de secours primaire de Paybox si différente de celle par défaut : https://tpeweb1.paybox.com/cgi/MYchoix_pagepaiement.cgi

URL du serveur de paiement de secours secondaire de Paybox si différente de celle par défaut : https://tpeweb2.paybox.com/cgi/MYchoix_pagepaiement.cgi

URL du serveur de paiement de secours tertiaire de Paybox si différente de celle par défaut : https://tpeweb3.paybox.com/cgi/MYchoix_pagepaiement.cgi

jusqu’à 150 caractères. facultatif jusqu’à 150 caractères. facultatif jusqu’à 150 caractères. facultatif

URL du serveur de paiement de secours quaternaire. jusqu’à 150 caractères. facultatif

>= 2.00

>= 2.00

>= 2.00

>= 2.00

PBX_PING

PBX_PORT

Demande de tests de disponibilité d’au moins un serveur de paiement PAYBOX [voir page 27]

Port TCP utilisé dans le cadre de la vérification de la disponibilité d’un serveur de paiement [voir page 27].

Valeur par défaut 443.

PBX_TYPEPAIEMENT Moyen de paiement à utiliser [voir page 28]

PBX_TYPECARTE

PBX_AUTOSEULE

PBX_RUF1

PBX_TIMEOUT

PBX_TIMEOUT1

PBX_TIMEOUT2

1 chiffre

1 à 5 chiffres facultatif facultatif

>= 2.00

>= 2.00 jusqu’à 32 caractères facultatif >= 2.00

Type de carte à utiliser [voir page 28] jusqu’à 32 caractères facultatif >= 2.00

La transaction sera uniquement en mode autorisation, c'est-àdire qu’elle ne sera pas envoyée à votre banque au moment de la télécollecte :

??

‘O’ : Autorisation seule (Pas de télécollecte de la transaction). Pour capturer la transaction (l’envoyer à votre banque au moment de la télécollecte), vous devez utiliser les traitements PAYBOX Traitement Par Lot

[voir page Erreur ! Signet non défini.] ou PAYBOX

Direct [voir pages Erreur ! Signet non défini. ou

Erreur ! Signet non défini.

].

??

‘N’ (par défaut) : Autorisation + capture (Télécollecte de la transaction).

Méthode utilisée (GET ou POST) pour l’appel de « l’url http

Directe » [voir page 14].

Valeur par défaut GET.

Temps d’attente (en secondes) pour vérifier la disponibilité du serveur de paiement primaire de Paybox.

Valeur par défaut : 8.

Temps d’attente (en secondes) pour vérifier la disponibilité du serveur de secours primaire de Paybox.

Valeur par défaut : 10.

Temps d’attente (en secondes) pour vérifier la disponibilité du serveur de secours secondaire de Paybox.

Valeur par défaut : 20.

1 caractère facultatif >= 2.10 jusqu’à 4 caractères

1 à 3 chiffres

1 à 3 chiffres

1 à 3 chiffres facultatif facultatif facultatif facultatif

>=2.00

>= 2.11

>= 2.11

>= 2.11

___________________________________________________________________________________________

PAYBOX SERVICES.

Centre Espace Sud – Route d’Elne - 66200 LATOUR BAS ELNE tél : 04.68.85.79.90 -fax : 04.68.85.79.99

Version 3.41 Page 8 sur 44