External Purchases - How To Connect CopeCart Integration

CopeCart Integration Help Documentation

Connect your CopeCart account to ClickFunnels to automatically create orders, contacts, and trigger automations from CopeCart purchases.

Overview

The CopeCart integration allows you to connect your CopeCart account to ClickFunnels through Instant Payment Notifications (IPN). When a customer makes a purchase, refund, or other transaction on CopeCart, ClickFunnels automatically:

• Creates a contact for the customer (or matches an existing one)

• Creates an order in your ClickFunnels workspace

• Updates order status for renewals, refunds, chargebacks, and cancellations

• Triggers automations, webhooks and workflows based on order events

This integration is part of the External Purchases feature.

Before You Begin

To set up the CopeCart integration, you need:

1. An active CopeCart account with at least one product configured

2. The External Purchases app enabled for your ClickFunnels workspace

3. At least one product created in ClickFunnels that you want to map to your CopeCart product

Setting Up the Integration

Step 1: Create an Endpoint Listener in ClickFunnels

1. In your ClickFunnels workspace, navigate to the External Purchases App

2. Click the yellow New Endpoint Listener button

3. Enter a Name for the listener (e.g., “CopeCart Integration”)

4. Select CopeCart as the Provider

5. Click Create

After creation, you will see two important values:

• Endpoint URL – The webhook URL in ClickFunnels that CopeCart will send notifications to

• Secret – The authentication secret used to verify webhook payloads

Copy both of these values. You will need them in the next step.

Step 2: Configure CopeCart IPN Settings

1. Log in to your CopeCart account

2. Go to Settings > IPN Integrations

3. Click Create New and select Generic as the integration type

4. Give the integration a name (e.g., “ClickFunnels”)

5. Paste the Endpoint URL from ClickFunnels into the Notification URL field

6. Paste the Secret from ClickFunnels into the Secret Key field

7. Click Activate and save your changes

Important: CopeCart integrations are per-product – you must enable the integration on each individual CopeCart product that you want to send notifications to ClickFunnels.

Step 3: Send a Test Event

After configuring the IPN settings in CopeCart:

1. Send a test event from CopeCart to verify the connection

2. Return to your endpoint listener in ClickFunnels

3. Check the Events section at the bottom of the page

4. You should see a new webhook event with a success status

If the test event appears with a green “success” badge, your integration is connected and working.

Mapping Products

Before CopeCart purchases can create orders in ClickFunnels, you need to map your CopeCart products to ClickFunnels products.

How to Find Your CopeCart Product ID

1. In your CopeCart account, go to Products

2. Click Edit on the product you want to map

3. Look at the URL in your browser – the Product ID is the number that comes after products/

4. Copy that number

Enabling IPN for a Product

Each CopeCart product must have IPN enabled to send notifications to ClickFunnels:

1. While editing the product in CopeCart, scroll down to the Integrations section

2. Click on the Generic Integration that is mapped to your ClickFunnels endpoint listener

3. Make sure it shows an Active badge

4. This ensures that IPN notifications will be sent to ClickFunnels for this product

Creating a Product Mapping

1. In ClickFunnels, go to your endpoint listener’s detail page

2. Click Map Products

3. Enter the CopeCart Product ID you copied earlier

4. Select the ClickFunnels Variant you want to map it to

5. Select the Product Price for that variant

6. Click Add Mapping

You can map multiple CopeCart products to different ClickFunnels products within the same endpoint listener. You can also point multiple CopeCart products to the same ClickFunnels product. However, you can’t map the same CopeCart twice.

Product Type Matching

When mapping CopeCart products to ClickFunnels products, it is important that the product types match as closely as possible:

CopeCart Product Type	Map To ClickFunnels
One-time purchase	One-time product
Subscription	Subscription product
Payment plan (breakdown payment)	Payment plan product
Trial	Product with trial enabled

Caution

Important: The price, duration, and recurrence frequency should match between CopeCart and ClickFunnels. For example, if your CopeCart product is a monthly subscription, map it to a monthly subscription in ClickFunnels. If you have a multi-product offer in CopeCart with multiple subscriptions, each subscription must use the same billing frequency for proper tracking.

Supported Events

The CopeCart integration processes the following transaction types:

Event	Description	What Happens in ClickFunnels
Payment Made (Initial)	First payment for a one-time purchase or subscription	Creates a new order and contact
Payment Made (Renewal)	Recurring subscription payment	Updates the existing order with a new invoice
Cancellation	Subscription cancelled	Updates the order status to cancelled
Refund (Full)	Full refund issued	Marks the order as fully refunded
Refund (Partial)	Partial refund issued	Records the partial refund on the order
Chargeback	Customer initiated a chargeback	Marks the order with chargeback status

Note: Renewal, refund, chargeback, and cancellation events require an existing order in ClickFunnels. If no matching order is found, the webhook will be saved with a “processing_skipped” status for your records.

How Refunds Work

When a refund is issued in CopeCart, ClickFunnels records it on the corresponding order. However, there is an important detail for orders with multiple invoices (e.g., subscription orders with several renewal payments):

• CopeCart’s refund notification does not specify which invoice was refunded

• Because of this, ClickFunnels will not mark the order as fully refunded until all invoices on the order have been refunded

• Individual refund events are still recorded on the order for your records

How Cancellations Work

When a subscription is cancelled in CopeCart:

• If the cancellation date is in the past, the order is churned (ended) immediately in ClickFunnels

• If the cancellation date is in the future, the order is marked as cancelled first and will be churned when that date arrives

• A refund in CopeCart may also trigger a cancellation notification alongside the refund notification – both are processed

Monitoring Webhooks

Webhook Statuses

You can monitor all incoming webhooks from your endpoint listener’s detail page. Each webhook displays a color-coded status badge:

Status	Color	Description
Pending	Yellow	Webhook received, awaiting processing
Success	Green	Successfully processed
Processing Skipped	Gray	Skipped (e.g., no matching order for a refund event)
Retrying	Orange	Processing failed, retrying automatically
Decryption Failed	Red	Could not verify webhook authenticity
Processing Failed	Red	General processing error
Order Creation Failed	Red	Could not create the ClickFunnels order
Refund Processing Failed	Red	Could not process the refund
Chargeback Processing Failed	Red	Could not process the chargeback

Viewing Webhook Details

For each webhook event, you can see:

• Event ID – Unique identifier

• Notification Type – The type of CopeCart event (e.g., payment_made, payment_refunded)

• Customer Email – The customer’s email (linked to their ClickFunnels contact)

• CF Order No. – Link to the corresponding ClickFunnels order

• CopeCart Order ID – Link back to the order in CopeCart

• Product ID – Link to the product in CopeCart

• Delivered At – When the webhook was received

• Full JSON Payload – The complete raw webhook data (available in the detail view)

Viewing External Purchase Webhooks on an Order

When viewing an order in ClickFunnels that was created by a CopeCart purchase, you will see an External Purchase Webhooks card on the order detail page. This shows all webhook events associated with that order, making it easy to trace the full history of a CopeCart transaction.

How Orders Are Created

When a CopeCart payment notification arrives:

1. Batch Collection – CopeCart sends a separate notification for each product in an order. ClickFunnels waits for a short period after the first notification arrives to collect all product notifications from the same order before processing.

2. Contact Lookup – ClickFunnels searches for an existing contact matching the customer’s email. If none is found, a new contact is created.

3. Product Matching – The CopeCart Product ID is matched against your product mappings to determine which ClickFunnels product was purchased.

4. Order Creation – A new order is created in your ClickFunnels workspace with the transaction details from CopeCart.

5. Automations Triggered – Any workflows or automations linked to order creation will fire.

Caution

Why do new webhooks show “Pending” status? CopeCart sends a separate notification for each product in a multi-product order. ClickFunnels batches these notifications and processes them together after a short delay. During this time, the webhook will appear with a yellow “Pending” badge. This is normal – the event will be processed automatically.

For subscription renewals, the system finds the existing order and adds a new invoice rather than creating a duplicate order.

Note: Invoice numbers are not generated for CopeCart orders. CopeCart manages its own invoice numbering independently.

Frequently Asked Questions

Q: Can I have multiple CopeCart endpoint listeners?

A: Yes, you can create multiple endpoint listeners for CopeCart. However, in most cases you only need one, where you map all your CopeCart products.

Q: Can I map multiple CopeCart products to the same ClickFunnels product?

A: Yes. Each mapping connects a specific CopeCart Product ID to a specific ClickFunnels variant and price, but multiple CopeCart products can point to the same ClickFunnels product.

Q: What happens if I receive a refund webhook but no order exists?

A: The webhook will be saved with a “processing_skipped” status and an error message explaining that no matching order was found. This applies to refunds, chargebacks, cancellations, and renewal events.

Q: Does the integration handle multi-product CopeCart orders?

A: Yes. CopeCart orders with multiple products are processed, and each product is matched against your product mappings.

Q: Are CopeCart orders assigned invoice numbers?

A: No. CopeCart manages its own invoice numbering, so ClickFunnels does not generate sequential invoice numbers for CopeCart orders.

Q: I set up the integration and now I’m seeing “processing_skipped” events. Why?

A: This happens when CopeCart sends an event (like a cancellation or refund) for an order that was placed before you set up the integration. Since ClickFunnels never received the original purchase event, there’s no matching order to update. These skipped events are saved for your

records but no action is taken. Going forward, all new purchases will be tracked from the initial payment.

Q: Why does my webhook show “Pending” for a while before processing?

A: CopeCart sends a separate notification for each product in a multi-product order.

ClickFunnels waits a short period to collect all notifications from the same order before processing them together. This ensures multi-product orders are created correctly.

Troubleshooting

“Webhook shows decryption_failed status”

Possible causes:

• The Secret in CopeCart does not match the Secret in your ClickFunnels endpoint listener

Solution:

• Go to your endpoint listener in ClickFunnels and copy the Secret

• Update the Secret in your CopeCart IPN integration settings to match exactly

• Send another test event to verify

“Webhook shows processing_skipped status”

Possible causes:

• A refund, chargeback, cancellation, or renewal event was received but no matching order exists in ClickFunnels

Solution:

• This is expected behavior if the original purchase was not processed through ClickFunnels

• Check the error message on the webhook detail page for specifics

• Ensure the initial payment event was received and processed successfully before subsequent events

“Webhook shows order_creation_failed status”

Possible causes:

• The CopeCart Product ID is not mapped to a ClickFunnels product

• The mapped ClickFunnels product or variant no longer exists

Solution:

• Go to your endpoint listener and click Map Products

• Verify the CopeCart Product ID is correctly mapped

• Ensure the mapped ClickFunnels product and price still exist

“No webhooks appearing in ClickFunnels”

Possible causes:

• IPN is not enabled for the product in CopeCart

• The endpoint URL is incorrect in CopeCart settings

• The Generic Integration is not set to Active in CopeCart

Solution:

• Verify the endpoint URL is correctly copied to CopeCart

• Edit the product in CopeCart and check the Integrations section

• Ensure the Generic Integration shows an Active badge

• Send a test event from CopeCart to confirm connectivity

“Customer contact not created”

Possible causes:

• The webhook payload does not contain a valid email address

Solution:

• Check the webhook detail page and inspect the JSON payload for customer email

• Verify the customer’s email is present in the CopeCart order