🏦 ClickBank And PayPal Setup

ClickBank and PayPal are both Tier 1 native integrations. WCT reads every field it needs from the notification itself, so there are no tokens to build into the URL.

ClickBank Setup:

1. Hoplinks are handled for you. Paste your raw ClickBank hoplink straight into the Destination URL field of your tracking link. WCT detects hop.clickbank.net and injects ?tid=<click_id> automatically. Power users can still set ?tid= by hand to override the automatic value.
2. In ClickBank go to Account Settings, then My Site, then Advanced Tools, then Instant Notification URL (INS).
3. Set INS Version to 6.0 or higher.
4. Paste this URL, making sure it starts with https: https://yoursite.com/index.php?wct_postback=1&source=clickbank
5. Copy your Secret Key from the same ClickBank screen into the ClickBank Secret Key box on the WCT Tracking tab and click Save Key.
6. Click Save in ClickBank, then use its Send Test to confirm a 200 response.

The Secret Key Is Required:

ClickBank sends every notification from INS 6.0 onward as an encrypted message, and WCT needs your Secret Key to read it. Without the key a notification is ignored and no sale is recorded. If the key does not match the one in your ClickBank account exactly, the notification cannot be read either. The key is stored on your site only and is never displayed back.

Use Only One Notification URL:

ClickBank notifies every URL you list, so two rows that both point at WCT mean two notifications for every sale. List WCT once.

Whether You Sold It Or Promoted It:

Both roles are handled. The amount WCT records is what you actually earn, with the full customer price kept alongside it. Buyer name, email, country, product and the affiliate nickname all come across, and a sale that carried a tracking ID attaches to the click that produced it.

ClickBank Events Handled Automatically:

SALE, BILL for rebills, RFND for refunds, CGBK for chargebacks, INSF for insufficient funds, which is treated as a refund, CANCEL-REBILL for cancellations and UNCANCEL-REBILL for reactivations.

PayPal Setup:

WCT auto detects PayPal IPN posts by the presence of payment_status, txn_id and payer_email, and reads every field from the body.

1. Pass the click ID through PayPal's custom field. For Buy Now and PayPal Standard buttons, add a hidden input named custom and fill its value server side, or with a shortcode or dynamic content plugin that reads the buyer's cookie. For PayPal Checkout and the SDK, set the custom property when you create the order. With WooCommerce, most PayPal gateways already populate custom from the order ID, so you usually need a small filter to inject the click ID instead.
2. In PayPal go to Profile, then My Selling Tools, then Instant Payment Notifications, then Choose IPN Settings.
3. Paste this URL: https://yoursite.com/index.php?wct_postback=1&source=paypal
4. Set Receive IPN messages to ON.
5. Save, then check PayPal's IPN history after the next sale to confirm delivery.

Optional PayPal Verification:

By default WCT accepts PayPal notifications without an extra round trip. If you want every notification checked with PayPal's own cmd=_notify-validate handshake, a developer can switch that on with add_filter('wct_paypal_verify_ipn', '__return_true'); Once it is on, any notification PayPal does not confirm as VERIFIED is rejected. The check adds roughly one to two seconds per notification, and PayPal sandbox notifications are checked against the sandbox.

PayPal Events Handled Automatically:

Completed becomes a sale. Refunded, Reversed and Denied become refunds. Subscription rebills arrive as txn_type=subscr_payment. Pending payments are skipped on purpose, because PayPal sends a second Completed notification once the payment clears.