eWay Rapid API

Intégration eWay Rapid API

Une passerelle de paiement en ligne sécurisée qui vous permet d’accepter facilement et sans tracas les paiements par carte de crédit via votre site web.

Rapid API est un produit de paiement qui permet aux commerçants d’envoyer les données de carte de crédit depuis le navigateur de leur client directement à eWAY, sans passer par le serveur du commerçant.

La méthode d’intégration utilise l’API et son champ personnalisé Option1 (ou Option2 ou Option3).

Veuillez suivre les étapes d’intégration uniquement si vous envoyez votre client vers un domaine différent – par exemple, demander les détails de la carte bancaire sur domainA.com et les rediriger vers domainB.com avec un message de résultat de paiement. Sinon, vous pouvez simplement utiliser la solution générale.

Intégration du champ personnalisé

La première étape consiste à définir le champ personnalisé Option1 (ou l’un des deux autres si vous utilisez déjà Option1). Pour obtenir la valeur nécessaire, vous pouvez utiliser au moins deux méthodes – en PHP, vous pouvez la lire depuis $_COOKIE[‘PAPVisitorId’] ou utiliser la méthode JavaScript PostAffTracker.writeCookieToCustomField() trouvée dans scripts/trackjs.js. Dans ce cas, vous devez garder à l’esprit qu’il s’agit d’une méthode JavaScript, donc vous devez récupérer la valeur avant d’envoyer la requête à eWay.

Lecture de la réponse

La deuxième étape consiste à ajouter le code de suivi des ventes au site défini comme RedirectUrl. eWay y enverra toutes les données, vous devrez donc traiter la réponse à cet endroit puis utiliser ces données dans le tracker de ventes.

Exemple 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

Si vous utilisez la nouvelle version Rapid 3.0, vous pouvez suivre les mêmes étapes ci-dessus, cependant, si vous souhaitez obtenir la valeur Option de la réponse, vous devez utiliser ce code :

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

Si vous utilisez Option2 ou Option3, le chiffre dans la ligne ci-dessus doit être modifié. Le chiffre est défini comme N-1.

Cela signifie que pour Option1 c’est 0, pour Option2 c’est 1 et pour Option3 c’est 2. N’oubliez pas d’intégrer sur votre site le code de suivi des clics.