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:
-->
