We have created a 3 step process to explain how you can integrate our custom incentive engine into your website. 

Simply, follow these steps:

1. Save our cookie "hash" value and transactionID into your DB

2. In IPN page (call by Paypal after a sale) look in DB for a "hash" that matches the transactionID

3. Use zferral's API:

https://<subdomain/&gt;.zferral.com/api/<token>/event/call.<format>

Call it by POST

XML request format:

<?xml version="1.0" encoding="UTF-8"?>
<event>
  <campaign_id>ZFERRAL CAMPAIGN ID</campaign_id>
  <revenue>TRANSACTION AMOUNT</revenue>
  <customer_id>CUSTOMER ID</customer_id> ( <-- optional param)
  <referer>HASH FROM COOKIE (saved erlier in DB)</referer>
  <unique_id>SOME UNIQUE ID (ex. transactionId)</unique_id>
</event>

The API Docs are located here: http://zferral.com/api-docs/event

As always, contact techsupport@zferral.com with questions!

Questions?  Please email techsupport@zferral.com. 

Follow these steps to ensure your purchases and commissions are being accurately tracked by zferral.

Follow these steps to embed the zferral tracker on your Paypal Buy Now button.

FOR NEW BUTTONS, if you have EXISTING Buttons Please Scroll Down to (Existing Buttons)

1. Sign-in to PayPal.com.
2. Click on the “Merchant Tools” tab.
3. Click on the “Buy Now Buttons” link under “Website Payments”.
4. When finished completing the fields of the “Buy Now Buttons” page, click the "Add More Options" button in the bottom right corner of the page.
5. In the Customize Your Buyer’s Experience section, find the Successful Payment URL text box. In this text box, enter the URL of the web page where you would like people to go (your conversion confirmation page) after they have completed their purchase.
   
   FOLLOW the directions here, to create the correct auto-return and return URL page: https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_html_paypal_shopping_cart#id08AEBJ0L04E
   
   Note: You will need to create a conversion confirmation web page that is separate from PayPal. You can store this page anywhere on the web. On this page, you will add the zferral code - any available: IMG pixel, JS or API call.
6. Add the JavaScript code snippet from zferral.  For directions on how to add the JavaScript code snippet to your website, please see the, ADDING A CODE SNIPPET section of this guide (COMING SOON).
7. When finished completing the fields of the “Customize Your Buyer’s Experience” page, click Create Button Now.
8. You can install the Buy Now Button you just created by copying the code in the HTML code for websites text box, and pasting this section of code into the code of your website. Use your HTML editor or a text editor to place this section of code in your web page so that it appears next to the product you are trying to sell.

FOR EXISTING BUTTONS

To edit existing PayPal Buy Now Buttons that send your customers to a URL that you specify after a purchase, complete the following tasks:

1. Edit the source of the page where you currently display a PayPal Buy Now Button.
2. While viewing the HTML code of this page, find the block of text that begins with  <form> and ends with </form>.
3. Immediately before the </form>, insert the zferral code - any available: IMG pixel, JS or API call.
4. Change the URL listed above to the URL of the conversion confirmation page where you will place the zferral code snippet.

ENSURING ACCURACY

In order to ensure there are no duplicate purchases tracked (due to page reloading) we STRONGLY RECOMMEND you pass to zferral a 'uniqueId' where your company should pass us an parameter that is unique for them (i.e. order id, payment id or something similar).

Follow these 6 steps to be fully integrate your affiliate commission payouts with PayPal! 

Questions?  Email us: support@zferral.com

1. Login to your PayPal account and click the "Profile" link in "My Account" bookmark.
    You can also click on "More Options" link in "Profile" bookmark
   
   
2. Click on the "Request API credentials" link under "Account Information" column.
   
   
   
   
3. Click on the "Grant API permission" link.
    If you have set up some permissions previously it may read "Add or Edit API Permissions".
   
   
   
   
   
4. Click on the "Configure a custom API authorization" link.
   
   
   
5. Enter "payments_api1.zferral.com" (w/o quotes) as the Partner API Username and tick the box named "MassPay".
   
   
   
   
6. Confirm API Permission by clicking the "Give Permission" button.
   
   
   You should be all set!  If you have any issues please let us know.