cynic Mon Feb 5 04:45:31 2001 EDT
Added files:
/phpdoc/cs/functions pfpro.xml
Log:
should be completely translated
Index: phpdoc/cs/functions/pfpro.xml
+++ phpdoc/cs/functions/pfpro.xml
<reference id="ref.pfpro">
<title>Funkce pro pr�ci s Verisign Payflow Pro</title>
<titleabbrev>Verisign Payflow Pro</titleabbrev>
<partintro>
<simpara>
Tato extenze umo��uje zpracov�vat kreditn� karty a prov�d�t jin� finan�n�
transakce pomoc� Verisign Payment Services (d��ve Signio, <ulink
url="&url.pfpro;">&url.pfpro;</ulink>).
</simpara>
<simpara>
Tyto funkce jsou dostupn� pouze pokud bylo PHP zkompilov�no s <option
role="configure">--with-pfpro[=DIR]</option>. Budete pot�ebovat SDK pro
va�i platformu, kter� se d� po registraci st�hnout z <ulink
url="&url.pfpro.download;">mana�ersk�ho rozhran�</ulink>.
</simpara>
<simpara>
Pokud jste si st�hli spr�vn� SDK, zkop�rujte n�sleduj�c� soubory z <filename
class="directory">lib</filename> adres��e t�to distribuce:
<filename>pfpro.h</filename> do <filename
class="directory">/usr/local/include</filename> a
<filename>libpfpro.so</filename> do <filename
class="directory">/usr/local/lib</filename>.
</simpara>
<simpara>
P�i vyu��v�n� t�chto funkc� m��ete vynechat vol�n�
<function>pfpro_init</function> a <function>pfpro_cleanup</function>, tato
extenze to ud�l� podle pot�eby automaticky. Tyto funkce jsou ale p�esto
dostupn� pro p��pad, �e byste pot�ebovali zpracov�vat velk� mno�stv�
transakc� a vy�adovali naprostou kontrolu nad touto knihovnou.
Mezi <function>pfpro_init</function> a <function>pfpro_cleanup</function>
m��ete prov�st libovoln� mno�stv� transakc�.
</simpara>
<simpara>
Tyto funkce byly p�id�ny v PHP 4.0.2.
</simpara>
<note><para>
Tyto funkce poskytuj� pouze spojen� s Verisign Payment Services. Kompletn�
detaily vy�adovan�ch parametr� viz Payflow Pro Developer's Guide.
</para></note>
</partintro>
<refentry id="function.pfpro-init">
<refnamediv>
<refname>pfpro_init</refname>
<refpurpose>Inicializovat Payflow Pro knihovnu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>pfpro_init</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
<function>pfpro_init</function> se pou��v� k inicializaci Payflow Pro
knihovny. Tuto funkci volat nemus�te, tato extenze automaticky zavol�
<function>pfpro_init</function> p�ed prvn� transakc�.
</para>
<para>
Viz tak� <function>pfpro_cleanup</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.pfpro-cleanup">
<refnamediv>
<refname>pfpro_cleanup</refname>
<refpurpose>Zav��t Payflow Pro knihovnu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>pfpro_cleanup</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
<function>pfpro_cleanup</function> se pou��v� k �ist�mu vypnut�
Payflow Pro knihovny. M�la by se volat po proveden� v�ech transakc� a p�ed
ukon�en�m skriptu. Tuto funkci nicm�n� volat nemus�te, tato extenze
automaticky zavol� <function>pfpro_cleanup</function> p�i ukon�en� skriptu.
</para>
<para>
Viz tak� <function>pfpro_init</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.pfpro-process">
<refnamediv>
<refname>pfpro_process</refname>
<refpurpose>Zpracovat transakci s Payflow Pro</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>pfpro_process</function></funcdef>
<paramdef>array <parameter>parameters</parameter></paramdef>
<paramdef>string
<parameter><optional>address</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>port</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>timeout</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>proxy address</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>proxy port</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>proxy logon</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>proxy password</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� asociativn� pole obsahuj�c� odpov��.
</para>
<para>
<function>pfpro_process</function> zpracuje transakci s Payflow Pro. Prvn�
argument je asociativn� pole obsahuj�c� kl��e a hodnoty, kter� se zak�duj�
a ode�lou zpracovateli.
</para>
<para>
Druh� argument je voliteln� a ur�uje serveer, ke kter�mu se p�ipojit.
Default je "test.signio.com", tak�e pokud chcete zpracov�vat skute�n�
transakce, budete cht�t tento argument nastavit na
"connect.signio.com".
</para>
<para>
T�et� argument ur�uje port, ke kter�mu se p�ipojit. Default je 443,
standardn� SSL port.
</para>
<para>
�tvrt� argument ur�uje v sekund�ch, jak� �asov� limit se m� pou��t.
Default je 30 sekund. Tento �asov� limit vstupuje v platnost v okam�iku
spojen� se zpracovatelem, a tak by v� skript mohl potenci�ln� b�et velmi
dlouhou dobu, pokud by nastaly probl�my s DNS nebo s�t�.
</para>
<para>
P�t� argument ur�uje hostname va�� p��padn� SSL proxy. �est� argument
specifikuje port.
</para>
<para>
Sedm� a osm� argument ur�uj� p�ihla�ovac� jm�no a heslo na tuto proxy.
</para>
<para>
Tato funkce vrac� asociativn� pole kl��� a hodnot odpov�di.
</para>
<note><para>
Kompletn� detaily vy�adovan�ch parametr� viz Payflow Pro Developer's Guide.
</para></note>
<example>
<title>Uk�zka Payflow Pro</title>
<programlisting role="php">
<?php
pfpro_init();
$transaction = array(USER => 'login',
PWD => 'heslo',
TRXTYPE => 'S',
TENDER => 'C',
AMT => 1.50,
ACCT => '4111111111111111',
EXPDATE => '0904'
);
$response = pfpro_process($transaction);
if (!$response) {
die("Nepoda�ilo se spojit s Verisign.\n");
}
echo "Response k�d Verisignu byl ".$response[RESULT];
echo ", co� znamen�: ".$response[RESPMSG]."\n";
echo "\nPo�adavek na transakci: ";
print_r($transaction);
echo "\nOdpov��: ";
print_r($response);
pfpro_cleanup();
?>
</programlisting>
</example>
</refsect1>
</refentry>
<refentry id="function.pfpro-process-raw">
<refnamediv>
<refname>pfpro_process_raw</refname>
<refpurpose>Zpracovat raw transakci s Payflow Pro</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pfpro_process_raw</function></funcdef>
<paramdef>string <parameter>parameters</parameter></paramdef>
<paramdef>string
<parameter><optional>address</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>port</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>timeout</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>proxy address</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>proxy port</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>proxy logon</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>proxy password</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� �et�zec obsahuj�c� odpov��.
</para>
<para>
<function>pfpro_process_raw</function> zpracuje raw �et�zec transakce s
Payflow Pro. Opravdu byste ale m�li pou��vat
<function>pfpro_process</function>, proto�e pravidla k�dov�n� t�chto transakc�
jsou nestandardn�.
</para>
<para>
Prvn� argument je v tomto p��pad� �et�zec obsahuj�c� raw po�adavek na
transakci. V�echny ostatn� argumenty jsou stejn� jako u
<function>pfpro_process</function>. N�vratov� hodnota je �et�zec obsahuj�c�
raw odpov��.
</para>
<note><para>
Kompletn� detaily vy�adovan�ch parametr� a pravidel k�dov�n� viz Payflow Pro
Developer's Guide. Dob�e v�m rad�me, pou��vejte rad�i
<function>pfpro_process</function>.
</para></note>
<example>
<title>Uk�zka Payflow Pro raw</title>
<programlisting role="php">
<?php
pfpro_init();
$response =
pfpro_process("USER=mylogin&PWD[5]=m&ndy&TRXTYPE=S&TENDER=C&AMT=1.50&ACCT=4111111111111111&EXPDATE=0904");
if (!$response) {
die("Nepoda�ilo se spojit s Verisign.\n");
}
echo "Raw odpov�� Verisignu byla ".$response;
pfpro_cleanup();
?>
</programlisting>
</example>
</refsect1>
</refentry>
<refentry id="function.pfpro-version">
<refnamediv>
<refname>pfpro_version</refname>
<refpurpose>Vr�tit verzi Payflow Pro knihovny</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pfpro_version</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
<function>pfpro_version</function> vrac� �et�zec obsahuj�c� verzi
Payflow Pro knihovny. V �ase psan� tohoto manu�lu to bylo L211.
</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:
-->