Connect SamCart

Updated Oct 25, 2026 · 4 min read · Pro, Business and Agency plans

This article shows you how to send your SamCart orders, upsells, renewals and refunds to PlayerMagick, so each sale is matched to the play that sold it.

Available on: Pro, Business and Agency plans.

How it works

SamCart's Webhooks app sends PlayerMagick a notification for each order, upsell, subscription payment, refund and cancellation. SamCart doesn't sign its notifications, so your receiver address is the key: it is long, random and shown only once. Keep it private. If you add your SamCart API key, PlayerMagick also checks each order with SamCart before counting it.

PlayerMagick adds pm=… to your buttons' SamCart checkout links. SamCart keeps every parameter of the link with the order and sends it back, so the match is exact. Upsells are matched through their first order. Renewals and refunds are matched to their order.

SamCart doesn't send chargebacks, so they can't be counted automatically.

Before you start

  • You need a SamCart account with the Webhooks app (under Apps).
  • Upsells and order bumps are SamCart Pro features. The API key is optional: SamCart support issues it on plans with API access.

Step 1: Connect SamCart in PlayerMagick

  1. Go to Settings → Sales platforms and click Connect a platform.
  2. Next to SamCart, click Connect, then Connect again.
  3. The setup page shows your receiver address. Copy it now: PlayerMagick shows it only once.

Step 2: Add the webhook in SamCart

  1. In SamCart, open Apps in the left menu, search for Webhooks and click Install.
  2. Paste the receiver address as the Notify URL and click Connect.
  3. Open the Installed tab, then Webhooks, and click + Add New Rule. Choose a Global Rule (all products) or a Product Specific Rule.
  4. Add a rule with the action Send NotifyURL Post for each trigger: checkout charged, Upsell purchased, subscription charged, Product refunded, Product partially refunded, Subscription charge refunded, Subscription charge partially refunded and subscription canceled.

Step 3: Optional: let PlayerMagick check orders with SamCart

If you have a SamCart API key, paste it into API key on the setup page and click Save. PlayerMagick then asks SamCart about each order before counting it: the order must exist, in the same currency, and the amount in the notification can't be more than the order's total. An order SamCart doesn't know shows as "Not counted: the platform's API doesn't confirm it"; one that doesn't match as "Not counted: the platform's API shows another amount, currency or code".

Step 4: Check it works

  • Click Send a test sale on the setup page. The result says what a real sale would be matched to. Test sales never count.
  • Then place a test order in SamCart and look for it under Recent notifications.

Point the player's buttons at your SamCart checkout pages. PlayerMagick adds pm=… when the viewer clicks. A buy button of your own page, outside the player, doesn't carry the code: those sales are matched by the buyer's email or counted as not matched.

If SamCart charges your Stripe or PayPal account and you connect that too, PlayerMagick skips a payment another connection already counted when SamCart sends the payment's id. If you see the same sale twice, turn off Count sales from this connection on one of them.

Troubleshooting

  • Waiting for the first notification. Check that the Notify URL is the whole address and that you added the rules.
  • Already recorded. SamCart sent the same order again (for example from two rules). It is counted once.
  • Not counted: the platform's API doesn't confirm it. The API key belongs to another SamCart account, or the notification didn't come from SamCart. Check the key; if you never shared the address, regenerate it.
  • An upsell refund shows on the first order. SamCart's refund names the order, not the upsell: the refund is taken off that order, so your revenue stays right.

Was this article helpful?