eWay Rapid API

Integracja eWay Rapid API

Bezpieczna bramka płatności online, która umożliwia łatwe i bezproblemowe przyjmowanie płatności kartą kredytową przez Twoją stronę internetową.

Rapid API to produkt płatniczy, który pozwala sprzedawcom przesyłać dane karty kredytowej bezpośrednio z przeglądarki klienta do eWAY, bez przechodzenia przez serwer sprzedawcy.

Metoda integracji wykorzystuje API oraz jego pole niestandardowe Option1 (lub Option2 albo Option3).

Wykonaj poniższe kroki integracyjne tylko wtedy, gdy przekierowujesz swojego klienta na inną domenę – np. prosisz o podanie danych karty na domainA.com, a następnie przekierowujesz go na domainB.com z komunikatem o wyniku płatności. W przeciwnym wypadku możesz po prostu użyć ogólnego rozwiązania.

Integracja pola niestandardowego

Pierwszym krokiem jest ustawienie pola niestandardowego Option1 (lub jednego z pozostałych dwóch, jeśli Option1 jest już używane). Aby uzyskać potrzebną wartość, możesz skorzystać z co najmniej dwóch sposobów – używając PHP możesz odczytać ją z $_COOKIE[‘PAPVisitorId’] lub możesz użyć metody JavaScript PostAffTracker.writeCookieToCustomField() znajdującej się w scripts/trackjs.js. W tym przypadku pamiętaj, że jest to metoda JavaScript, więc musisz pobrać wartość przed wysłaniem żądania do eWay.

Odczytywanie odpowiedzi

Drugim krokiem jest dodanie kodu śledzenia sprzedaży na stronie zdefiniowanej jako RedirectUrl. eWay wyśle tam wszystkie dane, więc musisz je tam przetworzyć i następnie użyć tych danych w trackerze sprzedaży.

Przykład PHP:

    ...
    $result = $result->GetAccessCodeResultResult;
    ?>
    
    <script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
    <script type="text/javascript">
    	PostAffTracker.setAccountId('Account_ID');
    	PostAffTracker.setVisitorId('<?php echo $result->Option1; ?>');
    	var sale = PostAffTracker.createSale();
    	sale.setTotalCost('<?php echo $result->TotalAmount; ?>');
    	sale.setOrderID('<?php echo $result->InvoiceNumber; ?>');
    	PostAffTracker.register();
    </script>

Rapid 3.0 API

Jeżeli korzystasz z nowej wersji Rapid 3.0, możesz wykonać powyższe kroki, jednak aby pobrać wartość Option z odpowiedzi, musisz użyć tego kodu:

$result->Options->Option[0]->Value

Jeśli korzystasz z Option2 lub Option3, liczba w powyższej linii musi się zmienić. Liczba jest zdefiniowana jako N-1.

Oznacza to, że dla Option1 jest to 0, dla Option2 to 1, a dla Option3 to 2. Nie zapomnij zintegrować swojej strony z kodem śledzenia kliknięć.