<?xml version="1.0" encoding="iso-8859-2"?>
 <reference id="ref.pfpro">
  <title>Funkce pro prci s Verisign Payflow Pro</title>
  <titleabbrev>Verisign Payflow Pro</titleabbrev>
  <partintro>
   <simpara>
    Tato extenze umouje zpracovvat kreditn karty a provdt jin finann
    transakce pomoc Verisign Payment Services (dve Signio, <ulink
    url="&url.pfpro;">&url.pfpro;</ulink>).
   </simpara>
   <simpara>
    Tyto funkce jsou dostupn pouze pokud bylo PHP zkompilovno s <option
    role="configure">--with-pfpro[=DIR]</option>. Budete potebovat SDK pro
    vai platformu, kter se d po registraci sthnout z <ulink
    url="&url.pfpro.download;">manaerskho rozhran</ulink>.
   </simpara>
   <simpara>
    Pokud jste si sthli sprvn SDK, zkoprujte nsledujc soubory z <filename
    class="directory">lib</filename> adrese tto 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>
    Pi vyuvn tchto funkc mete vynechat voln
    <function>pfpro_init</function> a <function>pfpro_cleanup</function>, tato
    extenze to udl podle poteby automaticky. Tyto funkce jsou ale pesto
    dostupn pro ppad, e byste potebovali zpracovvat velk mnostv
    transakc a vyadovali naprostou kontrolu nad touto knihovnou.
    Mezi <function>pfpro_init</function> a <function>pfpro_cleanup</function>
    mete provst libovoln mnostv transakc.
   </simpara>
   <simpara>
    Tyto funkce byly pidny v PHP 4.0.2.
   </simpara>

   <note><para>
    Tyto funkce poskytuj pouze spojen s Verisign Payment Services. Kompletn
    detaily vyadovanch 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>
     <methodsynopsis>
      <type>void</type><methodname>pfpro_init</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>pfpro_init</function> se pouv k inicializaci Payflow Pro
     knihovny. Tuto funkci volat nemuste, tato extenze automaticky zavol
     <function>pfpro_init</function> ped prvn transakc.
    </para>
    <para>
     Viz tak <function>pfpro_cleanup</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pfpro-cleanup">
   <refnamediv>
    <refname>pfpro_cleanup</refname>
    <refpurpose>Zavt Payflow Pro knihovnu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>pfpro_cleanup</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>pfpro_cleanup</function> se pouv k istmu vypnut
     Payflow Pro knihovny. Mla by se volat po proveden vech transakc a ped
     ukonenm skriptu. Tuto funkci nicmn volat nemuste, tato extenze
     automaticky zavol <function>pfpro_cleanup</function> pi ukonen 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>
     <methodsynopsis>
      <type>array</type><methodname>pfpro_process</methodname>
      <methodparam><type>array</type><parameter>parameters</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>address</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>proxy address</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>proxy port</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>proxy logon</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>proxy password</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac asociativn pole obsahujc odpov.
    </para>
    <para>
     <function>pfpro_process</function> zpracuje transakci s Payflow Pro. Prvn
     argument je asociativn pole obsahujc kle a hodnoty, kter se zakduj
     a odelou zpracovateli.
    </para>
    <para>
     Druh argument je voliteln a uruje serveer, ke ktermu se pipojit.
     Default je "test.signio.com", take pokud chcete zpracovvat skuten
     transakce, budete chtt tento argument nastavit na
     "connect.signio.com".
    </para>
    <para>
     Tet argument uruje port, ke ktermu se pipojit. Default je 443,
     standardn SSL port.
    </para>
    <para>
     tvrt argument uruje v sekundch, jak asov limit se m pout.
     Default je 30 sekund. Tento asov limit vstupuje v platnost v okamiku
     spojen se zpracovatelem, a tak by v skript mohl potenciln bet velmi
     dlouhou dobu, pokud by nastaly problmy s DNS nebo st.
    </para>
    <para>
     Pt argument uruje hostname va ppadn SSL proxy. est argument
     specifikuje port.
    </para>
    <para>
     Sedm a osm argument uruj pihlaovac jmno a heslo na tuto proxy.
    </para>
    <para>
     Tato funkce vrac asociativn pole kl a hodnot odpovdi.
    </para>

    <note><para>
     Kompletn detaily vyadovanch parametr viz Payflow Pro Developer's Guide.
    </para></note>

    <example>
     <title>Ukzka Payflow Pro</title>
     <programlisting role="php">
&lt;?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("Nepodailo se spojit s Verisign.\n");
}

echo "Response kd Verisignu byl ".$response[RESULT];
echo ", co znamen: ".$response[RESPMSG]."\n";

echo "\nPoadavek 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>
     <methodsynopsis>
      <type>string</type><methodname>pfpro_process_raw</methodname>
      <methodparam><type>string</type><parameter>parameters</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>address</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>proxy address</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>proxy port</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>proxy logon</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>proxy password</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac etzec obsahujc odpov.
    </para>
    <para>
     <function>pfpro_process_raw</function> zpracuje raw etzec transakce s
     Payflow Pro. Opravdu byste ale mli pouvat
     <function>pfpro_process</function>, protoe pravidla kdovn tchto transakc
     jsou nestandardn.
    </para>
    <para>
     Prvn argument je v tomto ppad etzec obsahujc raw poadavek na
     transakci. Vechny ostatn argumenty jsou stejn jako u
     <function>pfpro_process</function>. Nvratov hodnota je etzec obsahujc
     raw odpov.
    </para>

    <note><para>
     Kompletn detaily vyadovanch parametr a pravidel kdovn viz Payflow Pro
     Developer's Guide. Dobe vm radme, pouvejte radi
     <function>pfpro_process</function>.
    </para></note>

    <example>
     <title>Ukzka Payflow Pro raw</title>
     <programlisting role="php">
&lt;?php

pfpro_init();

$response = pfpro_process("USER=mylogin&amp;PWD[5]=m&amp;ndy&amp;TRXTYPE=S&amp;TENDER=C&amp;AMT=1.50&amp;ACCT=4111111111111111&amp;EXPDATE=0904");

if (!$response) {
  die("Nepodailo 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>Vrtit verzi Payflow Pro knihovny</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>pfpro_version</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>pfpro_version</function> vrac etzec obsahujc verzi
     Payflow Pro knihovny. V ase psan tohoto manulu 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->