Connect Gumroad

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

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

Available on: Pro, Business and Agency plans.

How it works

Gumroad's Ping sends PlayerMagick a notification for each sale. Gumroad doesn't sign its pings, so your receiver address is the key: it is long, random and shown only once. Keep it private. If you add a Gumroad access token, PlayerMagick also checks each sale with Gumroad before counting it.

PlayerMagick adds pm=… to your buttons' Gumroad product links. Gumroad keeps the link's parameters with the sale and sends them back, so the match is exact. Refunds and disputes are matched to their sale.

Gumroad reports amounts in US dollars, whatever your product's currency, so PlayerMagick shows Gumroad revenue in USD.

Step 1: Connect Gumroad in PlayerMagick

  1. Go to Settings → Sales platforms and click Connect a platform.
  2. Next to Gumroad, 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 Ping endpoint in Gumroad

  1. In Gumroad, open your account settings and find the Ping endpoint (under Advanced).
  2. Paste the receiver address and save.

Step 3: Optional: let PlayerMagick check sales with Gumroad

Create an application in your Gumroad settings, generate its access token and paste it into Access token on the setup page. PlayerMagick then asks Gumroad about each sale before counting it: the sale must exist with the same price and code. A sale Gumroad doesn't know shows as "Not counted: the platform's API doesn't confirm it"; one with another price as "Not counted: the platform's API shows another amount, currency or code". Refunds and disputes are checked the same way before they're applied.

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.
  • When you buy your own product, Gumroad marks the sale as a test: it shows under Recent notifications and never counts.

Point the player's buttons at your Gumroad product pages (https://….gumroad.com/l/…). 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.

Notifications that never arrived

Gumroad retries a ping for a few hours at most. If your address was down then, the sale is lost.

Add the optional Access token on the setup page and PlayerMagick checks Gumroad's API every few hours for anything whose notification never reached it. What it finds is counted like any other sale (once: an order PlayerMagick already has is never counted again) and shows in Recent notifications as "Recovered". The line above the list says when PlayerMagick last checked.

  • PlayerMagick looks at sales of the last 3 days that are at least 4 hours old, and at disputes of those sales. Refunds still come from the pings.

Troubleshooting

  • Waiting for the first notification. Check that the Ping endpoint is the whole address and saved.
  • Not counted: the platform's API doesn't confirm it. The access token belongs to another Gumroad account, or the ping didn't come from Gumroad. Check the token; if you never shared the address, regenerate it.
  • A partial refund shows as a full refund. Gumroad's refund ping doesn't say how much was refunded, so PlayerMagick treats it as a full refund.
  • Order not found (it may arrive later). Gumroad can send a refund before its sale. PlayerMagick looks again for up to a day.

Was this article helpful?