Dictionnaire des données

Pour PAYBOX SYSTEM

L’ensemble des variables PAYBOX SYSTEM est résumé dans ce tableau. Le détail de chaque variable – format, contenu, exemples – est donné après le tableau.

 VARIABLE  RÉSUME  
 PBX_1EURO_CODEEXTERNE  Données spécifique 1euro.com C
 PBX_1EURO_DATA  Données spécifique 1euro.com C
 PBX_2MONTn  Paiement en plusieurs fois : Montant des échéances F
 PBX_3DS  Désactivation 3-D Secure ponctuelle F
 PBX_ANNULE  URL de retour en cas d’abandon F
 PBX_ARCHIVAGE  Référence archivage F
 PBX_ATTENTE  URL de retour en cas de paiement en attente de validation F
 PBX_AUTOSEULE  Ne pas envoyer ce paiement à la banque immédiatement F
 PBX_CK_ONLY  Forçage d’un mode de paiement Carte Cadeau uniquement (non mixte) F
 PBX_CMD  Référence commande O
 PBX_CODEFAMILLE  Données spécifique Cofinoga C
 PBX_CURRENCYDISPLAY  Configuration des devises affichées F
 PBX_DATEn  Paiement en plusieurs fois : Dates des échéances F
 PBX_DEVISE  Devise (monnaie) O
 PBX_DIFF  Nombre de jours pour un paiement différé F
 PBX_DISPLAY  Timeout de la page de paiement F
 PBX_EFFECTUE  URL de retour en cas de succès F
 PBX_EMPREINTE  Empreinte fournie lors d’un premier paiement F
 PBX_ENTITE  Référence numérique d’un subdivision F
 PBX_ERRORCODETEST  Code erreur à renvoyer (pour tests) F
 PBX_GROUPE  Groupe pour Paybox Version ++ C
 PBX_HASH  Algorithme utilisé pour la signature du message O
 PBX_HMAC  Signature du message O
 PBX_IDABT  Numéro d’abonnement F
 PBX_IDENTIFIANT  Identifiant client Paybox O
 PBX_LANGUE  Langue de la page de paiement F
 PBX_MAXICHEQUE_DATA  Donnée spécifique Maxichèque C
 PBX_NBCARTESKDO  Nombre max de cartes cadeau utilisables par le porteur F
 PBX_NETRESERVE_DATA  Données spécifique Net Reserve C
 PBX_ONEY_DATA  Données spécifique Oney C
 PBX_PAYPAL_DATA  Données spécifiques à Paypal C
 PBX_PORTEUR  Adresse mail du client O
 PBX_RANG  Numéro de rang fourni par la banque O
 PBX_REFABONNE  Référence de l’abonne (version Plus) C
 PBX_REFUSE  URL de retour en cas de refus du paiement F
 PBX_REPONDRE_A  URL IPN F
  PBX_RETOUR  Configuration de la réponse O
 PBX_RUF1  Méthode d’appel de l’URL IPN F
 PBX_SITE  Numéro de site fourni par la banque O
 PBX_SOURCE  Format de la page de paiement (pour paiement mobile) F
 PBX_TIME  Date et heure de la signature O
 PBX_TOTAL  Montant O
 PBX_TYPECARTE  Forçage du moyen de paiement F
 PBX_TYPEPAIEMENT  Forçage du moyen de paiement F

Tableau 1 : Liste des variables Paybox System
Légende : O = Obligatoire ; F = Facultatif ; C = Conditionnel

Champs obligatoires pour Paybox System

PBX_SITE
Format : 7 chiffres. Obligatoire.
C’est le numéro de site (TPE) fourni par la banque du commerçant.
Exemple : 1999888 11.1.2

PBX_RANG
Format : 2 chiffres. Obligatoire.
C’est le numéro de rang (ou « machine ») fourni par la banque du Commerçant.
Exemple : 01

PBX_TOTAL
Format System : 3 à 10 chiffres. Obligatoire.
Format Direct : 10 chiffres. Obligatoire.
Montant total de la transaction en centimes (sans virgule ni point).
Exemple pour 19€90 : 1990

PBX_DEVISE
Format : 3 chiffres. Obligatoire.
Code monnaie de la transaction suivant la norme ISO 4217 (code numérique)
Exemples :

  • Euro : 978
  • US Dollar : 840
  • CFA : 952

Attention : Avant d’effectuer un paiement en devises, assurez-vous que votre banque et que votre contrat l’autorisent. Certains moyens de paiement ne supportent que l’euro. Dans ce cas, ils ne seront pas affichés sur la page de choix de moyen de paiement.

PBX_CMD
Format : 1 à 250 caractères. Obligatoire.
C’est la référence commande côté commerçant (champ libre). Ce champ permet au commerçant de garder un lien entre sa plate-forme de e-commerce et la plate-forme de paiement de Paybox. Ce champ doit être unique à chaque appel. Dans le cas de l’utilisation de Paybox System version PLUS, la valeur contenue dans ce champ est aussi utilisée comme référence d’abonné, utilisable dans Paybox Direct Plus.
Exemple : CMD9542124-01A5G

PBX_PORTEUR
Format : 6 à 80 120 caractères. Obligatoire.
Les caractères « @ » et « . » doivent être présents.
Adresse email de l’acheteur (porteur de carte).
Exemple : test@paybox.com

PBX_RETOUR
Format : <nom de variable>:<lettre>; Obligatoire.
Variables renvoyées par Paybox.

Ci-dessous, la liste complète des variables disponibles :

 CODE  DESCRIPTION
 M  Montant de la transaction (précisé dans PBX_TOTAL).
 R  Référence commande (précisée dans PBX_CMD) : espace URL encodé
 T  Numéro d’appel Paybox
 A  A numéro d’Autorisation (numéro remis par le centre d’autorisation) : URL encodé
 B  numéro d’abonnement (numéro remis par Paybox)
 C  Type de Carte retenu (cf. PBX_TYPECARTE)
 D  Date de fin de validité de la carte du porteur. Format : AAMM
 E  Code réponse de la transaction (cf. Tableau 3 : Codes réponse PBX_RETOUR
 F  État de l’authentification du porteur vis-à-vis du programme 3-D Secure :
• Y:Porteur authentifié
• A:Authentification du porteur forcée par la banque de l’acheteur
• U:L’authentification du porteur n’a pas pu s’effectuer
• N:Porteur non authentifié
 G  Garantie du paiement par le programme 3-D Secure. Format : O ou N
 H  Empreinte de la carte
 I  Code pays de l’adresse IP de l’internaute. Format : ISO 3166 (alphabétique)
 J   2 derniers chiffres du numéro de carte du porteur
 K   Signature sur les variables de l’URL. Format : url-encodé
 N  6 premiers chiffres (« biN6 ») du numéro de carte de l’acheteur
 O   Enrolement du porteur au programme 3-D Secure :
• Y:Porteur enrôlé
• N:Porteur non enrôlé
• U:Information non connue
o   Spécifique Cetelem : Option de paiement sélectionnée par le client :
• 005 : Comptant
• 001 : Crédit
P  Type de Paiement retenu (cf. PBX_TYPEPAIEMENT)
Q  Heure de traitement de la transaction. Format : HH:MM:SS (24h)
S  Numéro de TranSaction Paybox
U  Gestion des abonnements avec le traitement Paybox Direct Plus.

 Pour les paiements par carte :
Handle_Numéro_De_Carte_Crypté++Date_De_Validité_De_La_Carte++CVV—
Ce champ est URL-encodé. Vous devez conserver la valeur.

 Pour les paiements avec Paypal :
Ce champ contient l’identifiant de l’autorisation fourni par Paypal.
Il ne vous sera pas nécessaire pour les paiements suivants.

W  Date de traitement de la transaction sur la plateforme Paybox. Format : JJMMAAAA
Y  Code paYs  de la banque émettrice de la carte. Format : ISO 3166 (alphabétique)
Z  Index lors de l’utilisation des paiements mixtes (cartes cadeaux associées à un complément par carte CB/Visa/MasterCard/Amex)

Tableau 2 : Variables PBX_RETOUR

 CODE  DESCRIPTION
 00000  Opération réussie.
 00001  La connexion au centre d’autorisation a échoué ou une erreur interne est survenue. Dans ce cas, il est souhaitable de faire une tentative sur le site secondaire : tpeweb1.paybox.com.
 001xx  Paiement refusé par le centre d’autorisation [voir §12.112.1 Codes réponses du centre d’autorisationCodes réponses du centre d’autorisation]. En cas d’autorisation de la transaction par le centre d’autorisation de la banque ou de l’établissement financier privatif, le code erreur “00100” sera en fait remplacé directement par “00000”.
 00003   Erreur Paybox. Dans ce cas, il est souhaitable de faire une tentative sur le site secondaire FQDN tpeweb1.paybox.com.
 00004  Numéro de porteur ou cryptogramme visuel invalide.
 00006  Accès refusé ou site/rang/identifiant incorrect.
 00008  Date de fin de validité incorrecte.
 00009  Erreur de création d’un abonnement.
 00010  Devise inconnue.
 00011  Montant incorrect.
 00015  Paiement déjà effectué.
 00016  Abonné déjà existant (inscription nouvel abonné). Valeur ‘U’ de la variable PBX_RETOUR.
 00021  Carte non autorisée.
 00029  Carte non conforme. Code erreur renvoyé lors de la documentation de la variable « PBX_EMPREINTE ».
 00030  Temps d’attente > 15 mn par l’internaute/acheteur au niveau de la page de paiements.
 00031  Réservé
 00032  Réservé
 00033  Code pays de l’adresse IP du navigateur de l’acheteur non autorisé.
 00040  Opération sans authentification 3-DSecure, bloquée par le filtre.
 99999  Opération en attente de validation par l’émetteur du moyen de paiement.

Tableau 3 : Codes réponse PBX_RETOUR

Exemple : Mt:M;Ref:R;Auto:A;Appel:T;Abo:B;Reponse:E;Transaction:S;Pays:Y;Signature:K

PBX_IDENTIFIANT
Format : 1 à 9 chiffres. Obligatoire.
Identifiant Paybox fourni par Paybox au moment de l’inscription du commerçant.
Exemple : 200814357

PBX_HASH
Format : Texte. Obligatoire.
Valeur par défaut : SHA512
Définit l’algorithme de hachage utilisé lors du calcul du HMAC.

Cet algorithme doit être choisi parmi la liste suivante :

  • SHA512
  • RIPEMD160
  • SHA224
  • SHA256
  • SHA384
  • MDC2

Les hachages en MD2/4/5 sont jugés trop faibles pour être utilisés, nous ne les accepterons donc pas.
PBX_HASH doit être renseigné avec une des valeurs de cette liste, en respectant la casse (majuscules), et doit bien entendu correspondre au hachage utilisé pour le calcul du HMAC.
Si PBX_HASH n’est pas renseigné mais que dans les trames d’appel la variable PBX_HMAC est quand même renseignée (voir ci-dessous), l’algorithme de hachage sélectionné sera SHA512.  

PBX_HMAC
Format : Texte (format hexadécimal). Obligatoire.
Permet l’authentification du commerçant et la vérification de l’intégrité du message. Il est calculé à partir de la liste des autres variables envoyées à Paybox System.

Pour en savoir plus sur la génération de la clé HMAC, cliquez-ici.

PBX_TIME
Format : Date au format ISO8601. Obligatoire.
Date à laquelle l’empreinte HMAC a été calculée. Doit être URL-encodée.

Champs optionnels pour Paybox System

Les champs suivants sont triés par ordre alphabétique.

PBX_ARCHIVAGE
Format : jusqu’à 12 caractères alphanumériques (hors caractères spéciaux).
Référence transmise à la banque du commerçant au moment de la télécollecte. Elle devrait être unique et peut permettre à la banque du commerçant de lui fournir une information en cas de litige sur un paiement.  

PBX_AUTOSEULE
Format : O ou N.
Valeur par défaut : N
Si la variable vaut « O », la transaction sera uniquement en mode autorisation, c’est-à-dire qu’elle ne sera pas envoyée à la banque du commerçant au moment de la télécollecte.
Cependant, elle sera quand même bien enregistrée, et il sera possible de la capturer ultérieurement en utilisant les produits Paybox Traitement Par Lot ou Paybox Direct.

PBX_ANNULE
Format : jusqu’à 150 caractères
Valeur par défaut : valeur enregistrée dans la fiche client du commerçant
Page de retour de Paybox vers le site Marchand après paiement annulé. Les variables définies dans PBX_RETOUR seront envoyées à cette page
Exemple : http://www.commerce.fr/annulation.html

PBX_ATTENTE
Format : jusqu’à 150 caractères
Valeur par défaut : valeur enregistrée dans la fiche client du commerçant
Page de retour de Paybox vers le site Marchand après paiement en attente de validation par l’émetteur.
Les variables définies dans PBX_RETOUR seront envoyées à cette page
Exemple : http://www.commerce.fr/attente.html

PBX_CURRENCYDISPLAY
Format : jusqu’à 23 caractères (6 x 3 codes séparés par des virgules)
Valeur par défaut : toutes les devises sont affichées
Liste des codes monnaie à afficher au niveau de la page de paiements.

Les codes disponibles sont les suivants :

  • EUR : Euro
  • CHF : Franc suisse
  • USD : Dollar US
  • JPY : Yen
  • CNY : Yuan
  • GBP : Livre Sterling
  • CAD : Dollar canadien
  • NO_CURR : valeur spéciale pour n’afficher aucune devise

Exemple : EUR,USD,GBP

PBX_DATEVALMAX
Format : Date au format AAMM
Date d’expiration à ne pas dépasser.
Si la date de fin de validité de la carte est inférieure à la limite fixée par cette variable, le paiement sera refusé. Ceci est utile dans le cas des paiements en N fois et pour éviter qu’une reconduction échoue pour cause de date d’expiration de la carte dépassée.
Exemple :
Echéancier 04/05/2013, 08/06/2013 et 30/07/2013
PBX_DATEVALMAX=1307
Si la carte expire avant la fin juillet 2013, le paiement initial sera refusé avec le code erreur 00008.

PBX_DATE1, PBX_DATE2, PBX_DATE3
Format : Date au format JJ/MM/AAAA
Date de la seconde échéance d’un paiement fractionné (respectivement troisième et quatrième échéances pour PBX_DATE2 et PBX_DATE3).
Ces paramètres sont à utiliser obligatoirement en combinaison avec PBX_2MONT1, PBX_2MONT2, PBX_2MONT3.
Exemple : 30/06/2012

PBX_DIFF
Format : 2 chiffres
Nombre de jours de différé (entre la transaction et sa capture).
A noter qu’il est possible de supprimer cette mise en attente à partir du back office commerçant. Par exemple, une transaction réalisée le 2 novembre et différée jusqu’au 4 novembre, peut être débloquée et envoyée le 3 novembre par action manuelle.
Une valeur par défaut de ce paramètre peut avoir été définie dans la fiche d’inscription. Si ce paramètre est envoyé dans l’appel, la valeur spécifiée dans l’appel est prioritaire sur celle par défaut.
Exemple : 04 pour gérer un différé de 4 jours

PBX_DISPLAY
Format : 3 à 10 chiffres
Valeur par défaut : 900
TimeOut de la page de paiement (en secondes). Une fois cette période dépassée, la transaction est comptée comme annulée.

PBX_EFFECTUE
Format : jusqu’à 150 caractères
Valeur par défaut : valeur enregistrée dans votre fiche client
Page de retour de Paybox vers votre site après paiement accepté.
Les variables définies dans PBX_RETOUR seront envoyées à cette page.
Exemple : http://www.commerce.fr/confirmation.html

PBX_EMPREINTE
Format : 64 caractères
Empreinte fournie par Paybox au moment d’un premier paiement via la variable « H » de « PBX_RETOUR ».

PBX_ENTITE
Format : 1 à 9 chiffres
Référence numérique d’une subdivision géographique, fonctionnelle, commerciale, …

PBX_ ERRORCODETEST
Format : 5 chiffres
Code erreur à retourner lors de l’intégration dans l’environnement de pré-production. Variable non prise en compte dans l’environnement de production.

PBX_GROUPE
Format : jusqu’à 10 chiffres
Variable obligatoire pour l’utilisation de Paybox Version ++.
Définit le groupe de commerçants qui pourront réutiliser la même référence abonné pour débiter un même client.

PBX_IDABT
Format : 9 chiffres
Numéro d’abonnement renvoyé via la variable ‘B’ de PBX_RETOUR.
La documentation de cette variable permet de mettre à jour le numéro de carte associé à un abonnement. L’abonnement avait été initialement créé via le produit Paybox System.

PBX_LANGUE
Format : 3 caractères
Valeur par défaut : FRA
Langue utilisée par Paybox pour l’affichage de la page de paiement.
Valeurs possibles :

  • FRA : Français
  • GBR : Anglais
  • ESP : Espagnol
  • ITA : Italien
  • DEU : Allemand
  • NLD : Hollandais
  • SWE : Suédois
  • PRT : Portugais

PBX_REFABONNE
Format : jusqu’à 250 caractères
Référence abonné affectée par le commerçant via le produit Paybox Direct Plus ou Paybox System version PLUS.
La documentation de cette variable permet de mettre à jour le numéro de carte associé à un abonné ou profil s’il existe déjà, ou de le créer s’il n’existe pas.

PBX_REFUSE
Format : jusqu’à 150 caractères
Valeur par défaut : valeur enregistrée dans votre fiche client
Page de retour de Paybox vers le site Marchand après paiement refusé.
Les variables définies dans PBX_RETOUR seront envoyées à cette page.
Exemple : http://www.commerce.fr/refus.html

PBX_REPONDRE_A
Format : jusqu’à 150 caractères
Valeur par défaut : valeur enregistrée par Paybox à l’inscription dans la fiche client du commerçant
URL d’appel serveur à serveur après chaque tentative de paiement. Aussi appelée « IPN », cette URL est appelée séparément du navigateur du client, et permet donc de valider les commandes de manière sûre.
Les variables définies dans PBX_RETOUR seront envoyées à cette URL.
Exemple : http://www.commerce.fr/validation_paiement.cgi

PBX_RUF1
Format : « GET » ou « POST »
Valeur par défaut : GET
Méthode (au sens HTTP) utilisée pour l’appel de l’ « IPN »

PBX_SOURCE
Format : 3 à 5 caractères.
Valeur par défaut : HTML
Définit le format de la page du choix du moyen de paiement. Cette variable est à modifier en fonction du type de navigateur.
Les valeurs possibles sont les suivantes :

  • HTML : adaptée aux ordinateurs fixes
  • WAP : format WML, pour téléphones compatibles WAP
  • IMODE : format iHTML
  • XHTML : page allégée, adaptée aux terminaux mobiles (type smartphones/ tablettes)

Remarque : Paybox ne fait pas de détection automatique du navigateur.

PBX_TYPEPAIEMENT
Format : 5 à 10 caractères.
Valeur par défaut : <vide>
Privilégie un type de carte.

  • Sur la page de préselection : permet de n’afficher que les moyens de paiement choisis
  • Si le commerçant dispose de l’option Paypal par exemple mais qu’il souhaite limiter un achat aux paiements par carte, il faut documenter cette variable à « CARTE ».
  • Ainsi, seules les options de type carte dont le commerçant dispose seront affichées sur la page de présélection.
  • Sur la page de paiement : utilisée avec PBX_TYPECARTE, permet de ne pas afficher la page de présélection, et d’afficher la page de paiement adaptée directement.

Les valeurs possibles sont présentées dans le Tableau 4 ci-dessous.

PBX_TYPECARTE
Format : min. 2 caractères.
Valeur par défaut : <vide>
Définit le type de carte à utiliser sur la page de paiement, dans le cas où la page de présélection du moyen de paiement fournie par Paybox n’est pas utilisée. S’utilise toujours conjointement à PBX_TYPEPAIEMENT.

PBX_TYPEPAIEMENT PBX_TYPECARTE
CARTE CB, VISA, EUROCARD_MASTERCARD, E_CARD
MAESTRO
BCMC
AMEX
DINERS
JCB
COFINOGA
SOFINCO
AURORE
CDGP
24H00
RIVEGAUCHE
PAYPAL PAYPAL
CREDIT UNEURO
34ONEY
NETRESERVE NETCDGP
PREPAYEE SVS
KADEOS
PSC
CSHTKT
LASER
EMONEO
IDEAL
ONEYKDO
ILLICADO
WEXPAY
MAXICHEQUE
FINAREF SURCOUF
KANGOUROU
FNAC
CYRILLUS
PRINTEMPS
CONFORAMA
BUYSTER BUYSTER
LEETCHI LEETCHI
PAYBUTTONS PAYBUTTONS

Tableau 4 : Valeurs possibles PBX_TYPEPAIMENT et PBX_TYPECARTE

PBX_2MONT1, PBX_2MONT2, PBX_2MONT3
Format : 3 à 10 chiffres
Montant en centimes (donc sans virgule ni point) des échéances suivantes d’un paiement fractionné. L’option gestion des abonnements doit être activée.
Ces paramètres sont à utiliser obligatoirement en combinaison avec PBX_DATE1, PBX_DATE2, PBX_DATE3.

PBX_3DS
Format : ‘N’ : Pas d’authentification 3-D Secure du porteur
Permet de ne pas effectuer une authentification 3-D Secure du porteur, uniquement pour cette transaction, même si le commerçant est enrôlé au programme 3-D Secure.
Ne pas renseigner cette variable lorsque l’authentification 3-D Secure est demandée.

Variables spécifiques à certains moyens de paiement

PBX_1EURO_CODEEXTERNE
Format : 3 chiffres. Uniquement pour la solution de paiement « 1Euro.com ».
Offre promotionnelle externe

PBX_1EURO_DATA
Format : jusqu’à 100 caractères. Uniquement pour la solution de paiement « 1Euro.com ».
Données d’identification et de localisation du client.

Les données sont séparées par le caractère # et doivent respecter l’ordre suivant :

  1. Civilité,
  2. Nom,
  3. Prénom,
  4. Adresse1,
  5. Adresse2,
  6. Adresse3,
  7. Code postal,
  8. Ville,
  9. Code pays (FR pour France par exemple),
  10. Téléphone fixe,
  11. Téléphone portable,
  12. Flag indiquant si l’internaute est connu du commerçant (0 :Non connu, 1 :Connu),
  13. Flag indiquant si le commerçant a déjà eu des incidents de paiements avec cet internaute,
  14. Code action COFIDIS (valeur figée et fournie par COFIDIS)

Exemple : M#DUPONT#Jean#Rue Lecourbe#BatimentA##75010#PARIS#FR#0102030405##0#0#12#

PBX_CK_ONLY
Format : O ou N. Uniquement pour les cartes cadeau
La valeur « O » permet de forcer le paiement avec des cartes cadeau seulement. Sinon, le client peut aussi utiliser sa carte ou un autre moyen de paiement pour compléter son paiement.

PBX_CODEFAMILLE
Format : 3 chiffres. Uniquement pour les applications SOFINCO, COFINOGA et CDGP.
Valeur renseignée par le commerçant pour indiquer l’option de paiement qu’il propose au porteur de la carte SOFINCO (ou carte partenaire SOFINCO), COFINOGA ou CDGP.

PBX_MAXICHEQUE_DATA
Format : jusqu’à 255 caractères alphanumériques. Uniquement pour l’application MAXICHEQUE.
Décrit la famille du produit acheté. Voir documentation Maxichèque pour plus de détails.

PBX_NBCARTESKDO
Format : jusqu’à 2 chiffres. Uniquement pour les cartes cadeau.
Permet de limiter le nombre de cartes Cadeau utilisables par un porteur.
Les valeurs autorisées sont entre 1 et 25.

PBX_NETRESERVE_DATA
Format : jusqu’à 250 caractères. Uniquement pour l’application Net Reserve.
Données d’identification et de localisation du client.
Les données sont séparées par le caractère # et doivent respecter l’ordre suivant :

  1. Prénom (25 caractères),
  2. Nom (25 caractères),
  3. Adresse1 (25 caractères),
  4. Adresse2 (25 caractères),
  5. Code postal (10 caractères),
  6. Ville (25 caractères),
  7. Code pays (2 caractères : FR pour France par exemple),
  8. Email (50 caractères),
  9. Téléphone (25 caractères)

Exemple : 11.3.8 Jean#DUPONT#Rue Lecourbe##75010#PARIS#FR#jean.dupont@gmail.com#0102030405#

PBX_OPECOM
Format : 5 chiffres. Uniquement pour les paiements FINAREF avec la carte SURCOUF
Format : 10 caractères. Uniquement pour la solution Facilipay d’Oney Banque Accord.
Opération commerciale.

PBX_ONEY_DATA
Format : XML. Uniquement pour la solution Facilipay d’Oney Banque Accord.
Pour plus d’informations sur l’intégration de moyen de paiement, référez-vous au document : Note Oney.

PBX_PAYPAL_DATA
Format : jusqu’à 490 caractères. Uniquement pour l’application PAYPAL
Uniquement pour les paiements via Paypal : données d’identification de localisation du client.
Les données sont séparées par le caractère # et doivent respecter l’ordre suivant :

  1. Nom du client (32 caractères),
  2. 1ère ligne d’adresse (100 caractères),
  3. 2ème ligne d’adresse (100 caractères) ,
  4. Ville (40 caractères),
  5. Etat / Région (40 caractères),
  6. Code postal (20 caractères),
  7. Code pays (FR pour France) (2 caractères),
  8. Numéro de téléphone (20 caractères)
  9. Description du paiement (127 caractères)

Cette variable est obligatoire dans le cas d’un paiement avec création d’abonné (Paybox System version PLUS), conseillée dans les autres cas.
Exemple : PBX_PAYPAL_DATA=David VINCENT#11 Rue Jacques CARTIER##GUYANCOURT##78280#FR#0161370570#Ordinateur Portable

Paybox System Résiliation des Abonnements : Requête

VERSION
Format : 3 chiffres. Obligatoire.
Valeur par défaut : 001
Version de protocole : 001

TYPE
Format : 3 chiffres. Obligatoire.
Valeur par défaut : 001
Type de demande : 001 = Résiliation

SITE
Format : 7 chiffres. Obligatoire.
Numéro de site. Fourni par Paybox lors de l’inscription.

MACH
Format : 3 chiffres. Obligatoire.
Numéro de rang. Fourni par Paybox lors de l’inscription.

IDENTIFIANT
Format : 1 à 9 chiffres. Obligatoire.
Identifiant du commerçant pour Paybox. Fourni par Paybox lors de l’inscription. 

HMAC
Format : Texte. Obligatoire.
Permet l’authentification du commerçant et la vérification de l’intégrité du message. Son calcul se fait de la même manière que pour l’appel Paybox System.

TIME
Format : Date au format ISO8601. Obligatoire.
Date de calcul de l’empreinte HMAC.

ABONNEMENT
Format : 1 à 9 chiffres. Obligatoire si pas de référence de commande précisée.
Numéro d’abonnement à résilier.

REFERENCE
Format : 1 à 250 caractères. Obligatoire si pas de numéro d’abonnement précisé.
Référence commande de l’abonnement à préciser.

Paybox System Résiliation des Abonnements : Réponse

La réponse est fournie par l’intermédiaire de trois variables indiquant si la résiliation a réussi ou non, le motif de refus et un rappel sur l’abonnement.

ACQ
Format : 2 caractères. Obligatoire.

OK : Succès
NO : Echec

ERREUR
Format : 1 chiffre. Obligatoire en cas d’échec.

Numéro de l’erreur en cas d’échec :

  • 1 : Incident technique (Configuration),
  • 2 : Données non cohérentes,
  • 3 : Incident technique (Accès à la base de données),
  • 4 : Site inconnu,
  • 9 : Échec de la résiliation. Aucun abonnement résilié 

IDENTIFIANT
Format : 1 à 9 chiffres. Obligatoire.
Valeur transmise dans la requête initiale.

ABONNEMENT
Format : 1 à 9 chiffres. Obligatoire si pas de référence de commande précisée.
Valeur transmise dans la requête initiale.

REFERENCE
Format : 1 à 250 caractères. Obligatoire si pas de numéro d’abonnement précisé.
Valeur transmise dans la requête initiale.