Intégration page de paiement

Transcription

1 Intégration page de paiement Date Version Commentaires 09/03/ Version initiale 01/06/ Ajout sécurisation des données et modification du format du montant

2 Sommaire Introduction... 3 Solutions... 3 Formulaire «bancaire»... 4 Formulaire «complet»... 5 Cryptage du montant... 6 Messages d erreur... 7

3 Introduction La page de paiement FACTOBOX vous permet de finaliser une commande ou réservation sur votre site internet. Elle s intègre de façon très simple, à savoir par un simple appel d URL, avec un certain nombre de paramètres permettant la réalisation du paiement, et le retour du résultat vers le site commerçant. Solutions Afin de répondre à des besoins réglementaires, nous demandons des éléments obligatoires sur le porteur de la carte de crédit utilisée pour le paiement. Dans cette optique, nous proposons 2 solutions : Soit le site commerçant peut nous fournir les éléments obligatoires, dans ce cas nous proposons un formulaire qui permet de saisir simplement les coordonnées bancaires. Soit le site commerçant ne peut fournir les éléments obligatoires, dans ce cas nous proposons un formulaire complet qui permet à l utilisateur de saisir ses coordonnées personnelles et bancaires. Une fois la transaction terminée, un retour est effectué au site commerçant afin de l avertir du résultat de la transaction, et ainsi, conclure ou non l objet de la transaction.

4 Formulaire «bancaire» L URL à appeler : « via la méthode «GET» avec les paramètres ci-dessous. Les variables sont les suivantes : Variable Présence Libellé montant Obligatoire Montant de la transaction transmis en centimes d euro (Donnée cryptée, et la valeur cryptée doit être encodée en base64). ref Obligatoire Référence de la transaction contractnumber Obligatoire Numéro de contrat (fourni après création accès plateforme) key Obligatoire Clé de contrôle de la variable contractnumber (fourni après création de l accès à la plateforme) iv Obligatoire Paramètre de cryptage du montant (cf cryptage du montant) URLretour Facultatif URL de retour vers le commerce URLnotif Obligatoire URL sur laquelle transmettre les informations en retour indictest Facultatif Indicateur de test (mettre 1 pour mode Test, ne pas renseigner pour passer en mode Production) nomporteur Obligatoire Nom de l acheteur prenomporteur Obligatoire Prénom de l acheteur adresseporteur Facultatif Adresse de l acheteur compladresseporteur Facultatif Complément adresse de l acheteur codepostalporteur Facultatif Code postal de l acheteur villeporteur Facultatif Ville de l acheteur paysporteur Obligatoire Pays de l acheteur porteur Obligatoire de l acheteur telephoneporteur Obligatoire Téléphone de l acheteur Le numéro de contrat est une variable qui nous permet d identifier le commerçant sur la plateforme de paiement. Il sera communiqué ultérieurement lorsque l accès à notre plateforme sera ouvert avec sa clé de contrôle. Les valeurs renvoyées après le paiement : Référence de la transaction Nom de l acheteur de l acheteur Téléphone de l acheteur Résultat du paiement (échoué si valeur <> et ) (*) Mode de paiement (égale à FACTOBOX ) ref namebuyer buyer phonebuyer resultat modepaiement Une fois le paiement terminé, les informations ci-dessus sont envoyées via la méthode «POST» à l URL contenu dans la variable URLnotif. (*) cf la partie «Messages d erreur» pour connaître les messages d erreurs à interpréter.

5 Formulaire «complet» L URL à appeler : « via la méthode «GET» avec les paramètres ci-dessous. Les variables sont les suivantes : Variable Présence Libellé montant Obligatoire Montant de la transaction transmis en centime d euro (Donnée cryptée, et la valeur cryptée doit être encodée en base64). ref Obligatoire Référence de la transaction contractnumber Obligatoire Numéro de contrat (fourni après création de l accès à la plateforme) key Obligatoire Clé de contrôle de la variable contractnumber (fournie après création accès plateforme) iv Obligatoire Paramètre de cryptage du montant (cf cryptage du montant) URLretour Facultatif URL de retour vers le commerce URLnotif Obligatoire URL sur laquelle transmettre les informations en retour indictest Facultatif Indicateur de test (mettre 1 pour mode Test, ne pas renseigner pour passer en mode Production) Le numéro de contrat est une variable qui nous permet d identifier le commerçant sur la plateforme de paiement. Il sera communiqué ultérieurement lorsque l accès à notre plateforme sera ouvert avec sa clé de contrôle. Les valeurs renvoyées après le paiement : Référence de la transaction ref Nom de l acheteur namebuyer de l acheteur buyer Téléphone de l acheteur phonebuyer Résultat du paiement (échoué si valeur <> )(*) resultat Mode de paiement (égale à FACTOBOX ) modepaiement Une fois le paiement terminé, les informations ci-dessus sont envoyées via la méthode «POST» à l URL contenu dans la variable URLnotif. (*) cf la partie «Messages d erreur» pour connaître les messages d erreurs à interpréter.

6 Cryptage du montant Pour des raisons de sécurité, la variable montant doit être transmise de façon cryptée afin d empêcher les utilisateurs de modifier sa valeur. Pour cela, nous utilisons le cryptage 3DES, avec une clé de cryptage que nous vous fournissons lors de l ouverture de l accès à la plateforme FACTOBOX. Voici un exemple de script PHP à mettre en place du côté «Commerçant» pour crypter le montant : // Calcul de la taille du vecteur pour le cryptage $iv_taille = mcrypt_get_iv_size(mcrypt_3des, MCRYPT_MODE_CFB); // Génération d une chaîne de caractère aléatoire de la taille du vecteur $iv = mcrypt_create_iv($iv_taille, MCRYPT_RAND); // Cryptage du montant $montant=mcrypt_encrypt(mcrypt_3des,$cryptkey,$montantacrypter, MCRYPT_MODE_CFB, $iv); // Encodage BASE64 $montant = base64_encode($montant) ; La valeur de la variable «$cryptkey» est fournie en même temps que les valeurs pour les variables contractnumber et key. La variable $iv fait partie de la liste des paramètres à transmette lors de l appel de la page de paiement (paramètre du même nom). Attention, le type et le mode de cryptage doit être respecté, à savoir «MCRYPT_3DES» et «MCRYPT_MODE_CFB», sinon le décryptage ne pourra fonctionner, et donc le client ne pourra régler sa facture.

7 Messages d erreur Vous trouverez ci-dessous une liste de messages d erreur concernant les paramètres transmis : Code erreur Motif La clé de contrôle ne correspond pas avec la variable «contractnumber» Erreur sur le cryptage du montant