Sogénactif est le système de paiement proposé par la société générale. Il utilise le système développé par le groupe ATOS.

Comment intégrer le système Sogénactif sur votre site ?

Comment fonctionne le système de paiements Sogénactif ?

Détail des flux d'information

• (1) Le visiteur termine ses achats, et arrive sur la page de votre site qui lui présente le montant total à régler, et les moyens de paiements proposés. C'est dans cette page que doit être inclu l'extrait de programme qui affiche le résultat de l'appel au script request.cgi, c'est à dire les cartes bancaires acceptées.
• (2) Le visiteur clique sur la carte qu'il veut utiliser pour la transaction. Il est ensuite amené sur le site de la banque où il saisit son numéro de carte bancaire.
• (3) Lorsque le serveur de la banque affiche le résultat de la transaction (transaction réussie, numéro de carte invalide, etc.), il appelle en même temps le CGI autoresponse.cgi.
• (3bis) Le programme autoresponse.cgi envoit un email vers l'adresse que vous aurez précisée lors de l'installation du système, et appelle éventuellement un CGI de votre site avec les paramètres de la transaction communiqués par la banque. Ce CGI, dont l'URL doit également être précisé lors de l'installation, vous permet par exemple de stocker le résultat du paiement dans une base de données, d'écrire le résultat dans un fichier, etc.
• (4) Sur le site de la banque, le visiteur clique sur le bouton "retour au site web". Dans ce cas, le résultat du CGI response.cgi situé sur le serveur paisec.ovh.net est affiché dans le navigateur du visiteur. Si le visiteur choisit de ne pas cliquer sur ce bouton, et, par exemple, ferme son navigateur, response.cgi n'est pas appelé. (C'est pourquoi le CGI autoresponse.cgi est appelé auparavant: on est ainsi certains de recevoir le résultat de la transaction).
• (4bis) Le script response.cgi lit les données retournées par la banque et redirige le navigateur du visiteur vers une URL de votre site.
  Vous pouvez préciser lors de l'installation du système deux URL différentes qui seront appelées selon le code de retour de la transaction.
  Cette URL peut aussi être un CGI, auquel cas il lui est passé en paramètres les données retournés par la banque. Ce CGI ainsi appelé peut alors afficher dans le navigateur du visiteur une page différente selon le résultat de la transaction.

Extraits de script

Exemple en PHP:

<?      
    $login="VOTRELOGIN"; // il s'agit de votre login sur notre serveur paisec.ovh.net
    
    //--- url-encodage des paramètres
    $amount = urlencode($total);
    $orderId = urlencode($numero_commande);
    $currencyCode = 978;
     
    $serverUrl="http://paisec.ovh.net";
    $cgiPath="/~$login/sogenactif/request.cgi?";
    $cgiParams="amount=$amount&order_id=$orderId&currency_code=$currencyCode";

    //--- récupération du formulaire affichant le bouton
    $myfile = file("$serverUrl$cgiPath$cgiParams");

    //--- affichage de la liste des cartes bancaires
    for($index = 0; $index > count($myfile); $index++)
    {       
            print ($myfile[$index]);
    }
?>

Exemple en perl:

    use LWP::Simple;
    use URI::Escape;

    #--- récupération du formulaire affichant le bouton

    my $login="VOTRELOGIN"; # il s'agit de votre login sur notre serveur paisec.ovh.net

    my $serverUrl="http://paisec.ovh.net";
    my $cgiUrl="/~$login/sogenactif/request.cgi?";

    my $amount='amount=' . uri_escape($total);
    my $orderId='&order_id=' . uri_escape($numero_commande);
    my $currencyCode='&currency_code=978';

    my $cgiParams="$amout$orderId$currencyCode";

    #--- appel du CGI:
    my $cardsForm = get "$serverUrl$cgiUrl$cgiParams";

    #--- affichage des cartes bancaires acceptées:
    print $cardsForm;

Paramètres de transaction

• amount: (obligatoire)
  Le montant de la transaction à réaliser. Il doit être précisé dans la plus petite unité de la devise utilisée (en centimes par exemple si la devise est le franc français).


• currency_code: (défaut: déterminé lors de l'installation)
  Indique la devise de la facture proposée à l'internaute. (en format ISO-IS 4217)



978: Euro	840: Dollar américan
124: Dollar canadien	826: Livre Sterling
392: Yen japonais



• language_code: (défaut: déterminé lors de l'installation)
  Langage utilisé pour les pages textes (sur deux caractères, voir liste ci-dessous.)

en: english	da: danois
fr: français	fi: finnois
ge: allemand	sw: suédois
it: italien	po: portuguais
sp: espagnol	no: norvégien
du: néerlandais



• caddie: (défaut: aucun)
  Informations sur le panier de l'internaute. Ce champ est simplement retourné par le serveur de la banque.


• data: (défaut: aucun)
  Contient des informations personnelles sur la transaction qui sont seulement retournées par le serveur de la banque. (peut être parfois utilisé par le serveur de la banque. Se renseigner auprès d'eux.)


• return_context: (défaut: aucun)
  Contient des informations personnelles sur la transaction qui sont seulement retournées par le serveur de la banque. (non utilisé par le serveur de la banque.)


• receip_complement: (défaut: aucun)
  Nous n'avons pas pu trouver de documentation sur ce paramètre.