eWay Rapid API

Integrácia eWay Rapid API

Bezpečná online platobná brána, ktorá vám umožní jednoducho a bez starostí prijímať platby kreditnou kartou cez vašu webstránku.

Rapid API je platobný produkt, ktorý umožňuje obchodníkom posielať údaje o kreditnej karte priamo z prehliadača zákazníka do eWAY bez toho, aby tieto údaje prechádzali cez server obchodníka.

Metóda integrácie využíva API a jeho vlastné pole Option1 (alebo Option2 alebo Option3)

Postupujte podľa týchto krokov integrácie len v prípade, že posielate svojho zákazníka na inú doménu – napr. žiadate údaje o karte na domainA.com a presmerujete ich na domainB.com so správou o výsledku platby. V opačnom prípade stačí použiť všeobecné riešenie.

Integrácia vlastného poľa

Prvým krokom je nastavenie vlastného poľa Option1 (alebo jedného z ďalších dvoch, ak už používate Option1). Pre získanie požadovanej hodnoty máte aspoň dve možnosti – pomocou PHP ju načítate z $_COOKIE[‘PAPVisitorId’] alebo použijete JavaScriptovú metódu PostAffTracker.writeCookieToCustomField() zo súboru scripts/trackjs.js. V tomto prípade si treba uvedomiť, že ide o JavaScriptovú metódu, takže hodnotu musíte získať ešte pred odoslaním požiadavky do eWay.

Čítanie odpovede

Druhým krokom je pridať sledovací kód predaja na stránku, ktorá je určená ako RedirectUrl. eWay tam pošle všetky údaje, takže ich musíte spracovať a použiť odpoveď v predajnom sledovači.

Príklad v 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

V prípade, že používate novú verziu Rapid 3.0, môžete postupovať podľa rovnakých krokov vyššie, avšak ak chcete získať hodnotu Option z odpovede, použite tento kód:

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

Ak používate Option2 alebo Option3, číslo v riadku vyššie je potrebné zmeniť. Číslo sa určuje ako N-1.

To znamená, že pre Option1 je to 0, pre Option2 je to 1 a pre Option3 je to 2. Nezabudnite integrovať vašu stránku so sledovacím kódom kliknutí.