How It Works

When a transaction event occurs, JVZoo sends an HTTP POST to the IPN v2 URL you configure in your product settings. Your script verifies the request, then processes it.

V1 and V2 are independent — you can configure one, both, or neither on each product. They fire from separate URLs and use different verification algorithms.

Setup

1. In JVZoo, go to your product's Advanced Settings and select JVZIPN v1 / JVZIPN v2 / KeyGen / External Program
2. Enter your endpoint URL in the JVZIPN V2 URL field
3. Set a Secret Key — used to verify incoming requests. Navigate to My Account → Seller Settings to create one
4. Save your settings

Transaction Types

POST Fields

All fields are sent as application/x-www-form-urlencoded. Amounts are in dollars (not pennies — this differs from v1).

Transaction

Product

Customer

Vendor

Affiliate

Tax & Fees

Recurring Subscription

These fields are only populated for RECURRING products.

Delivery Address

Only populated when the product collects shipping information.

Transaction Payouts

transactionPayouts is a JSON-encoded string within the form body. It is only present when payout data exists. Always check before parsing.

JSON[
  {
    "payee_amount": 33.60,
    "payee_user_id": 11111,
    "payee_name": "ACME Corp",
    "payout_type": "VENDOR",
    "payment_processor": "PayPal",
    "payout_status": "Settled"
  },
  {
    "payee_amount": 9.40,
    "payee_user_id": 67890,
    "payee_name": "Jane Smith",
    "payout_type": "AFFILIATES",
    "payment_processor": "PayPal",
    "payout_status": "Settled"
  },
  {
    "payee_amount": 4.00,
    "payee_user_id": 1,
    "payee_name": "JVZoo",
    "payout_type": "JVZOO",
    "payment_processor": "JVZoo",
    "payout_status": "Settled"
  }
]

Sample Payload

A typical JVZIPN v2 POST (values sanitized):

POST bodycustomer_first_name: Jamie
customer_last_name: Rivers
customer_email: jamie.rivers@example.com

delivery_name: Jamie Rivers
delivery_phone: +1-843-555-0199
delivery_address_line_1: 742 Evergreen Lane
delivery_address_line_2:
delivery_city: Seaside
delivery_region: FL
delivery_postal_code: 33004
delivery_country: UNITED_STATES

product_id: 20455
product_name: Premium Webinar Toolkit
product_type: STANDARD

transaction_type: SALE
transaction_id: 9TX000111Z999000A
paykey: PT-9TX000111Z999000A

affiliate_id: 17
affiliate_name: Growth Labs LLC
affiliate_email: partners@growthlabs.example

vendor_id: 42
vendor_name: Acme Digital Corp
vendor_email: billing@acmedigital.example

total: 97.00
payment_method: PYPL
status: COMPLETED
date: 2024-09-11 12:16:42

tax_total: 0.00
shipping_fee: 0.00

cverify: 8F9C3A12
other_params:
next_payment_date:
start_date:
end_date:

transactionPayouts: [...]

Verifying Requests

Algorithm

1. Concatenate these 5 fields in this exact order, separated by pipes, with a trailing pipe after the last field:
   
   paykey|customer_email|product_name|transaction_type|date|
2. Append your Secret Key (no pipe after the secret)
3. Convert to UTF-8
4. Compute SHA-1
5. Take the first 8 characters, uppercase

PHP Example

PHP<?php
$secretKey = 'your_secret_key_here';

$paykey           = $_POST['paykey'] ?? '';
$customer_email   = $_POST['customer_email'] ?? '';
$product_name     = $_POST['product_name'] ?? '';
$transaction_type = $_POST['transaction_type'] ?? '';
$date             = $_POST['date'] ?? '';
$incoming_verify  = $_POST['cverify'] ?? '';

$string = $paykey . '|'
    . $customer_email . '|'
    . $product_name . '|'
    . $transaction_type . '|'
    . $date . '|'
    . $secretKey;

$calculated = strtoupper(substr(sha1(mb_convert_encoding($string, 'UTF-8')), 0, 8));

if ($calculated !== $incoming_verify) {
    http_response_code(403);
    die('Verification failed');
}

// Verified — process the transaction
$type   = $_POST['transaction_type'];
$email  = $_POST['customer_email'];
$amount = $_POST['total']; // Already in dollars

// Parse payouts if present
$payouts = [];
if (!empty($_POST['transactionPayouts'])) {
    $payouts = json_decode($_POST['transactionPayouts'], true);
}

switch ($type) {
    case 'SALE':
        grantAccess($email);
        break;
    case 'RFND':
        revokeAccess($email);
        break;
    case 'BILL':
        extendAccess($email, $_POST['next_payment_date']);
        break;
}

http_response_code(200);
echo 'OK';

Python Example

Pythonimport hashlib
import json
from flask import Flask, request

app = Flask(__name__)
SECRET_KEY = 'your_secret_key_here'

@app.route('/ipn/v2', methods=['POST'])
def handle_ipn_v2():
    data = request.form

    string = '|'.join([
        data.get('paykey', ''),
        data.get('customer_email', ''),
        data.get('product_name', ''),
        data.get('transaction_type', ''),
        data.get('date', ''),
    ]) + '|' + SECRET_KEY

    calculated = hashlib.sha1(string.encode('utf-8')).hexdigest()[:8].upper()

    if calculated != data.get('cverify', ''):
        return 'Verification failed', 403

    txn_type = data.get('transaction_type')
    email    = data.get('customer_email')
    amount   = data.get('total')  # Already in dollars

    # Parse payouts if present
    payouts = []
    if data.get('transactionPayouts'):
        payouts = json.loads(data['transactionPayouts'])

    if txn_type == 'SALE':
        grant_access(email)
    elif txn_type == 'RFND':
        revoke_access(email)
    elif txn_type == 'BILL':
        extend_access(email)

    return 'OK', 200

Working with transactionPayouts

Loop through the payouts array to record who received what on each transaction — useful for accounting, reporting, and affiliate reconciliation.

PHP

PHP$payouts = isset($_POST['transactionPayouts'])
    ? json_decode($_POST['transactionPayouts'], true)
    : [];

foreach ($payouts as $payout) {
    $amount    = $payout['payee_amount']      ?? 0;
    $payeeId   = $payout['payee_user_id']     ?? null;
    $payeeName = $payout['payee_name']        ?? '';
    $type      = $payout['payout_type']       ?? '';
    $processor = $payout['payment_processor'] ?? '';
    $status    = $payout['payout_status']     ?? '';

    // store or process each payout row
}

Python

Pythonpayouts_raw = data.get('transactionPayouts', '')
payouts = json.loads(payouts_raw) if payouts_raw else []

for payout in payouts:
    amount    = payout.get('payee_amount')
    payee_id  = payout.get('payee_user_id')
    payee     = payout.get('payee_name')
    ptype     = payout.get('payout_type')
    processor = payout.get('payment_processor')
    status    = payout.get('payout_status')

Migrating from v1

If you already have a v1 handler, this table shows how v1 fields map to their v2 equivalents:

FAQ

Key Points