[PHP-DOC] cvs: phpdoc /fr/functions cybermut.xml

[Damien Seguy]

dams            Mon Jul 23 12:51:06 2001 EDT

  Added files:                 
    /phpdoc/fr/functions        cybermut.xml 
  Log:
  Initial translation
  

Index: phpdoc/fr/functions/cybermut.xml
+++ phpdoc/fr/functions/cybermut.xml
 <reference id="ref.cybermut">
  <title>CyberMUT : Cr&eacute;dit Mutuel</title>
  <titleabbrev>CyberMUT</titleabbrev>
  <partintro>
   <simpara>
    Cette extension vous permet de traiter des transactions de
    cartes de cr&eacute;dits, avec le syst&egrave;me due Cr&eacute;dit Mutuel : 
CyberMUT
    (<ulink url="&url.cybermut;">&url.cybermut;</ulink>).
   </simpara>
   <simpara>
    CynerMUT est un syst&egrave;me de paiement fran&ccedil;ais, propos&eacute; par le
    Cr&eacute;dit Mutuel. Si vous n'&ecirc;tes pas r&eacute;sidants fran&ccedil;ais, 
ces fonctions
    ne vous seront pas utiles.
   </simpara>
   <simpara>
    Cette extension n'est disponible que si PHP a &eacute;t&eacute; compil&eacute; par 
l'option
    <link linkend="install.configure.with-cybermut"><option role="configure">
    --with-cybermut[=DIR]</option></link>, o&ugrave; DIR est le dossier qui
    contient les fichiers <filename>libcm-mac.a</filename> et 
<filename>cm-mac.h</filename>.
    Vous aurez besoin du SDK appropri&eacute;, qui vous est fournit apr&egrave;s vous
    &ecirc;tes inscrit &agrave; CyberMUT (via le web, ou &agrave; votre agence la plus 
proche).
   </simpara>
   <simpara>
    L'utilisation de ces fonctions est presque identique aux fonctions originales,
    hormis le fait que les fonctions <function>cybermut_creerformulairecm</function>
    et <function>cybermut_creerreponsecm</function>, qui sont retourn&eacute;es
    directement par des fonctions PHP, au lieu d'&ecirc;tre pass&eacute;es par 
r&eacute;f&eacute;rence
    aux fonctions originales.
   </simpara>
   <simpara>
    Ces fonctions ont &eacute;t&eacute; ajout&eacute;e en 4.0.6.
   </simpara>
   <note>
    <para>
     These functions only provide a link to CyberMUT SDK. Be sure to read the
     CynerMUT Developers Guide for full details of the required parameters.
    </para>
   </note>
  </partintro>
  <refentry id="function.cybermut_creerformulairecm">
   <refnamediv>
    <refname>cybermut_creerformulairecm</refname>
    <refpurpose>G&eacute;n&egrave;re un formulaire HTML de paiement</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>cybermut_creerformulairecm</function></funcdef>
      <paramdef>string <parameter>url_CM</parameter></paramdef>
      <paramdef>string <parameter>version</parameter></paramdef>
      <paramdef>string <parameter>TPE</parameter></paramdef>
      <paramdef>string <parameter>montant</parameter></paramdef>
      <paramdef>string <parameter>ref_commande</parameter></paramdef>
      <paramdef>string <parameter>texte_libre</parameter></paramdef>
      <paramdef>string <parameter>url_retour</parameter></paramdef>
      <paramdef>string <parameter>url_retour_ok</parameter></paramdef>
      <paramdef>string <parameter>url_retour_err</parameter></paramdef>
      <paramdef>string <parameter>langue</parameter></paramdef>
      <paramdef>string <parameter>code_societe</parameter></paramdef>
      <paramdef>string <parameter>texte_bouton</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>cynermut_creerformulairecm</function> g&eacute;n&egrave;re un
     formulaire HTML, de demande de paiement.
    </para>
    <example>
     <title>Premi&egrave;re &eacute;tape du paiment (&eacute;quivalent &agrave; 
cgi1.c)</title>
     <programlisting role="php">
&lt;?php
// Dossier contenant les cl&eacute;s de chiffrement
putenv("CMKEYDIR=/var/creditmut/cles");
// Num&eacute;ro de version
$VERSION="1.2";
  $retour =  creditmut_creerformulairecm(
  "https://www.creditmutuel.fr/test/telepaiement/paiement.cgi";,
  $VERSION,
  "1234567890",
  "300FRF",
  $REFERENCE,
  $TEXTE_LIBRE,
  $URL_RETOUR,
  $URL_RETOUR_OK,
  $URL_RETOUR_ERR,
  "francais",
  "company",
  "Paiement par carte bancaire");
  echo $retour;
?&gt;
     </programlisting>
    </example>
    <para>
     Voir aussi
     <function>cybermut_testmac</function> et
     <function>cybermut_creerreponsecm</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.cybermut_testmac">
   <refnamediv>
    <refname>cybermut_testmac</refname>
    <refpurpose>
     V&eacute;rifie le message de confirmation
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>bool <function>cybermut_testmac</function></funcdef>
      <paramdef>string <parameter>code_MAC</parameter></paramdef>
      <paramdef>string <parameter>version</parameter></paramdef>
      <paramdef>string <parameter>TPE</parameter></paramdef>
      <paramdef>string <parameter>cdate</parameter></paramdef>
      <paramdef>string <parameter>montant</parameter></paramdef>
      <paramdef>string <parameter>ref_commande</parameter></paramdef>
      <paramdef>string <parameter>texte_libre</parameter></paramdef>
      <paramdef>string <parameter>code-retour</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>cybermut_testmac</function> s'assure qu'il n'y a pas de donn&eacute;es
     parasites dans le message de confirmation recu. Attention aux param&egrave;tres
     <literal>code-retour</literal> and <literal>texte-libre</literal>, qui ne
     peuvent pas &ecirc;tre utilis&eacute;s directement, car ils contienent des tirets
     dans leur nom. Vous devez utilisez la syntaxe suivante :
     <programlisting role="php">
&lt;?php
  $code_retour=$HTTP_GET_VARS["code-retour"];
  $texte_libre=$HTTP_GET_VARS["texte-libre"];
?&gt;
     </programlisting>
    </para>
    <example>
     <title>Deuxi&egrave;me &eacute;tape de paiement (&eacute;quivalent &agrave; 
cgi2.c)</title>
     <programlisting role="php">
&lt;?php
// Assurez vous que l'option Enable Track Vars est active.
// Dossier qui contient les cl&eacute;s de paiement
putenv("CMKEYDIR=/var/creditmut/cles");
// Num&eacute;ro de version
$VERSION="1.2";
$texte_libre = $HTTP_GET_VARS["texte-libre"];
$code_retour = $HTTP_GET_VARS["code-retour"];
$mac_ok = 
creditmut_testmac($MAC,$VERSION,$TPE,$date,$montant,$reference,$texte_libre,$code_retour);
if ($mac_ok) {
  //
  // Gestion d'un paiement r&eacute;ussi
  //
  //
  $result=creditmut_creerreponsecm("OK");
  } else {
  $result=creditmut_creerreponsecm("Document Falsifi&eacute;");}
?&gt;
     </programlisting>
    </example>
    <para>
     Voir aussi
     <function>cybermut_creerformulairecm</function> et
     <function>cybermut_creerreponsecm</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.cybermut_creerreponsecm">
   <refnamediv>
    <refname>cybermut_creerreponsecm</refname>
    <refpurpose>
     G&eacute;n&egrave;re un accus&eacute; de r&eacute;ception de confirmation de 
paiement
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>cybermut_creerreponsecm</function></funcdef>
      <paramdef>string <parameter>phrase</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>cybermut_creerreponsecm</function> retourne une cha&icirc;ne contenant
     le message d'accus&eacute; de reception.
    </para>
    <para>
     Le param&egrave;tre vaut "OK" si le message de confirmation du paiament
     a &eacute;t&eacute; correctement indentifi&eacute; par 
<function>cybermut_testmac</function>.
     Tout autre cha&icirc;ne doit &ecirc;tre consid&eacute;r&eacute; comme une erreur 
de traitement.
    </para>
    <para>
     Voir aussi
     <function>cybermut_creerformulairecm</function> et
     <function>cybermut_testmac</function>.
    </para>
   </refsect1>
  </refentry>
 </reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->