eWay Rapid API

eWay Rapid API-integratie

Een veilige online betaalgateway waarmee je eenvoudig en probleemloos creditcardbetalingen via je website kunt accepteren.

Rapid API is een betaalproduct waarmee handelaren creditcardgegevens rechtstreeks vanuit de browser van hun klant naar eWAY kunnen sturen, zonder dat deze via de server van de handelaar gaan.

De integratiemethode maakt gebruik van de API en het aangepaste veld Option1 (of Option2 of Option3).

Volg de integratiestappen alleen als je je klant naar een ander domein stuurt – bijvoorbeeld wanneer je creditcardgegevens vraagt op domainA.com en ze vervolgens naar domainB.com doorstuurt met een betalingsresultaat. Anders kun je gewoon de algemene oplossing gebruiken.

Integratie van aangepast veld

De eerste stap is het instellen van het aangepaste veld Option1 (of een van de andere twee als je Option1 al gebruikt). Om de benodigde waarde te krijgen, kun je minimaal twee manieren gebruiken – met PHP kun je deze uitlezen uit $_COOKIE[‘PAPVisitorId’] of je kunt de JavaScript-methode PostAffTracker.writeCookieToCustomField() gebruiken, te vinden in scripts/trackjs.js. Houd er in dit geval rekening mee dat het een JavaScript-methode is, dus je moet de waarde ophalen voordat je het verzoek naar eWay stuurt.

Respons uitlezen

De tweede stap is het toevoegen van de verkooptrackingcode aan de site die is ingesteld als RedirectUrl. eWay zal daar alle gegevens naartoe sturen, dus je moet de respons daar verwerken en vervolgens de responsgegevens gebruiken in de verkooptracker.

PHP-voorbeeld hier:

    ...
    $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

Als je de nieuwe Rapid 3.0-versie gebruikt, kun je dezelfde stappen als hierboven volgen. Als je echter de Option-waarde uit de respons wilt halen, gebruik dan deze code:

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

Als je Option2 of Option3 gebruikt, moet het getal in bovenstaande regel worden aangepast. Het getal wordt bepaald als N-1.

Dit betekent: voor Option1 is het 0, voor Option2 is het 1 en voor Option3 is het 2. Vergeet niet je website te integreren met de kliktrackingcode.