we need to keep logs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@126447 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Nicolas Chaillan 2003-05-10 09:04:36 +00:00
parent 22382aaceb
commit 2f5fe8aec2

View file

@ -1,24 +1,16 @@
<!-- D O N O T E D I T T H I S F I L E ! ! !
it is still here for historical reasons only
(as translators may need to check old revision diffs)
if you want to change things documented in this file
you should now edit the files found under en/reference
instead -->
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.21 $ -->
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.22 $ -->
<reference id="ref.cybermut">
<title>Cr&eacute;dit Mutuel CyberMUT functions</title>
<titleabbrev>CyberMUT</titleabbrev>
<partintro>
<simpara>
This extension allows you to process credit cards transactions using Cr&eacute;dit
Mutuel CyberMUT system (<ulink url="&url.cybermut;">&url.cybermut;</ulink>).
This extension allows you to process credit cards transactions using
Cr&eacute;dit Mutuel CyberMUT system (
<ulink url="&url.cybermut;">&url.cybermut;</ulink>).
</simpara>
<simpara>
CyberMUT is a popular Web Payment Service in France, provided by the
CynerMUT is a popular Web Payment Service in France, provided by the
Cr&eacute;dit Mutuel bank. If you are foreign in France, these functions will not
be useful for you.
</simpara>
@ -57,37 +49,38 @@
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>cybermut_creerformulairecm</methodname>
<methodparam><type>string</type><parameter>url_CM</parameter></methodparam>
<methodparam><type>string</type><parameter>version</parameter></methodparam>
<methodparam><type>string</type><parameter>TPE</parameter></methodparam>
<methodparam><type>string</type><parameter>montant</parameter></methodparam>
<methodparam><type>string</type><parameter>ref_commande</parameter></methodparam>
<methodparam><type>string</type><parameter>texte_libre</parameter></methodparam>
<methodparam><type>string</type><parameter>url_retour</parameter></methodparam>
<methodparam><type>string</type><parameter>url_retour_ok</parameter></methodparam>
<methodparam><type>string</type><parameter>url_retour_err</parameter></methodparam>
<methodparam><type>string</type><parameter>langue</parameter></methodparam>
<methodparam><type>string</type><parameter>code_societe</parameter></methodparam>
<methodparam><type>string</type><parameter>texte_bouton</parameter></methodparam>
</methodsynopsis>
<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>cybermut_creerformulairecm</function> is used to generate the
<function>cynermut_creerformulairecm</function> is used to generate the
HTML form of request for payment.
</para>
<example>
<title>First step of payment (equiv cgi1.c)</title>
<programlisting role="php">
<![CDATA[
<?php
// Directory where the keys are located
&lt;?php
// Directory where are located the keys
putenv("CMKEYDIR=/var/creditmut/cles");
// Version number
$VERSION="1.2";
$retour = cybermut_creerformulairecm(
$retour = creditmut_creerformulairecm(
"https://www.creditmutuel.fr/test/telepaiement/paiement.cgi",
$VERSION,
"1234567890",
@ -102,8 +95,7 @@ $VERSION="1.2";
"Paiement par carte bancaire");
echo $retour;
?>
]]>
?&gt;
</programlisting>
</example>
<para>
@ -124,37 +116,35 @@ $VERSION="1.2";
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>cybermut_testmac</methodname>
<methodparam><type>string</type><parameter>code_MAC</parameter></methodparam>
<methodparam><type>string</type><parameter>version</parameter></methodparam>
<methodparam><type>string</type><parameter>TPE</parameter></methodparam>
<methodparam><type>string</type><parameter>cdate</parameter></methodparam>
<methodparam><type>string</type><parameter>montant</parameter></methodparam>
<methodparam><type>string</type><parameter>ref_commande</parameter></methodparam>
<methodparam><type>string</type><parameter>texte_libre</parameter></methodparam>
<methodparam><type>string</type><parameter>code-retour</parameter></methodparam>
</methodsynopsis>
<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> is used to make sure that there was
not data diddling contained in the received message of confirmation.
Pay attention to parameters <parameter>code-retour</parameter> and
<parameter>texte-libre</parameter>, which cannot be evaluated as is,
because of the dash. You must retrieve them by using:
Pay attention to parameters code-retour and texte-libre, which cannot be
evaluated as is, because auf the dash. You must retrieve them by using:
<programlisting role="php">
<![CDATA[
<?php
&lt;?php
$code_retour=$HTTP_GET_VARS["code-retour"];
$texte_libre=$HTTP_GET_VARS["texte-libre"];
?>
]]>
?&gt;
</programlisting>
</para>
<example>
<title>Last step of payment (equiv cgi2.c)</title>
<programlisting role="php">
<![CDATA[
<?php
&lt;?php
// Make sure that Enable Track Vars is ON.
// Directory where are located the keys
putenv("CMKEYDIR=/var/creditmut/cles");
@ -165,7 +155,7 @@ $VERSION="1.2";
$texte_libre = $HTTP_GET_VARS["texte-libre"];
$code_retour = $HTTP_GET_VARS["code-retour"];
$mac_ok = cybermut_testmac($MAC,$VERSION,$TPE,$date,$montant,$reference,$texte_libre,$code_retour);
$mac_ok = creditmut_testmac($MAC,$VERSION,$TPE,$date,$montant,$reference,$texte_libre,$code_retour);
if ($mac_ok) {
@ -174,13 +164,11 @@ if ($mac_ok) {
//
//
$result=cybermut_creerreponsecm("OK");
} else {
$result=cybermut_creerreponsecm("Document Falsifie");
}
$result=creditmut_creerreponsecm("OK");
} else {
$result=creditmut_creerreponsecm("Document Falsifie");}
?>
]]>
?&gt;
</programlisting>
</example>
<para>
@ -201,17 +189,19 @@ if ($mac_ok) {
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>cybermut_creerreponsecm</methodname>
<methodparam><type>string</type><parameter>phrase</parameter></methodparam>
</methodsynopsis>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>cybermut_creerreponsecm</function></funcdef>
<paramdef>string <parameter>phrase</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>cybermut_creerreponsecm</function> returns a string containing
delivery acknowledgement message.
delivery aknowledgement message.
</para>
<para>
The parameter is "OK" if the message of confirmation of the payment
was correctly identified by <function>cybermut_testmac</function>.
were correctly auhentified by <function>cybermut_testmac</function>.
Any other chain is regarded as an error message.
</para>
<para>
@ -222,7 +212,6 @@ if ($mac_ok) {
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@ -232,7 +221,6 @@ sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil