Instalacja uproszczona

Co jest niezbędne?

Przede wszystkim należy się zarejestrować zgodnie z procedurą rejestracji. Aby skorzytać z serwisu Przelewy24 musisz na Twoich stronach WWW dodać tylko link przy danym produkcie(usłudze) przesyłając nam kilka niezbędnych parametrów.

Przebieg transakcji

Instalacja - instrukcja techniczna

1. Żądanie transakcji

Przed wysłaniem żądania transakcji nie jest konieczne zapisywanie jakiejkolwiek informacji w Państwa bazie danych. Żądaniem transakcji może być link z parametrami lub formularz, z którego metodą GET zostaną te parametry przekazane na adres http://sklep.przelewy24.pl. Parametrami są:

• z24_id_sprzedawcy - identyfikator sprzedawcy (nadany po rejestracji), wymagane
• z24_nazwa - tytuł płatności, wymagane
• z24_return url - adres powrotu z formularza zamówienia
• z24_kwota - kwota transakcji wyrażona w groszach (np. 1.23 PLN = 123), wymagane
• z24_opis - pole opcjonalne do wprowadzenia dodatkowego opisu/uwag
• z24_language - wybór wersji językowej, pl - polska (domyślny), en - angielska
  
  
• k24_nazwa - nazwa klienta (imię nazwisko/firma)
• k24_email - adres e-mail klienta
• k24_kraj - kod kraju klienta, np. "pl"
• k24_kod - adres klienta - kod
• k24_miasto - adres klienta - miasto
• k24_ulica - adres klienta - ulica
• k24_numer_dom - adres klienta - numer domu
• k24_numer_lok - adres klienta - numer lokalu

Przykładowo może powstać link:

http://sklep.przelewy24.pl/zakup.php?z24_id_sprzedawcy=TWOJ_ID&z24_kwota=128000& z24_nazwa=RezerwacjNR%3A+04%2F234%2FA3953&z24_return_url=http%3A%2F%2Ftwojsklep.pl

Lub można skorzystać z formularza:

<form method="get" action="http://sklep.przelewy24.pl/zakup.php">
<input type="hidden" name="z24_id_sprzedawcy" value="TWOJ_ID">
<input type="hidden" name="z24_return_url" value="TWOJASTRONA.PL">
<input type="hidden" name="z24_language" value="pl">
<table>
<tr>
<td align="right">Nazwa produktu:</td>
<td>
<input type="text" name="z24_nazwa" value="Opłata za rezerwację NR: 04/234/A3953">
</td>
</tr>
<tr>
<td align="right">Dodatkowy opis:</td>
<td>
<textarea name="z24_opis" style="width:250px">Dodatkowe informacje...</textarea>
</td>
</tr>
<tr>
<td align="right">Do zapłaty:</td>
<td><input type="text" name="z24_kwota"></td><!--KWOTA W GROSZACH-->
</tr>
</table>
<input type="submit" value="zapłać z przelewy24.pl">
</form>

UWAGA! Kwota przekazywana w formularzu musi być podana w groszach, więc, o ile klient ma możliwość jej wprowadzenia samodzielnie, należy wartość pola z24_kwota odpowiednio przekonwertować.

Przykład gotowego formularza razem z mechanizmem konwersji kwoty na grosze można pobrać klikając tutaj...

Wszystkie pola formularza, poza z24_id_sprzedawcy i z24_return_url, które powinny być wyłacznie polami ukrytymi, mogą być prezentowane w postaci pól z możliwością edycji dla klienta (type="text") bądź jako pola ukryte, niewidoczne dla klienta (type="hidden").

2. Opcje mechanizmu

Na życzenie klienta, możliwe jest dostosowanie ilości i typu pól oraz wyglądu formularza zamówienia. Nie jest również konieczne przekazywane wszystkich parametrów wymienionych w punkcie 1, do poprawnego wywołania niezbędne są trzy (zaznaczone). Dane dotyczące klienta, jeżeli nie zostaną przekazane zostaną pobrane od klienta już na formularzu zamówienia.

3. Pewność transakcji

Aby mieć pewność, iż otrzymałeś potwierdzenie zamówienia na swoją skrzynkę pocztową w przekazywanym mailu zawarty będzie link zwrotny. Jego zadaniem jest przekazanie do serwisu potwierdzenia odbioru maila. Dopóki link zwrotny nie zostanie wywołany, mail będzie cyklicznie wysyłany na Twoją skrzynkę. Domyślnie cykl sprawdzania potwierdzenia wyności 1 godzinę.