Connect Digistore24
This article shows you how to send Digistore24's payments, upsells, rebills, refunds and chargebacks to PlayerMagick, so each sale is matched to the play that sold it.
Available on: Pro, Business and Agency plans.
How it works
Digistore24's IPN (instant payment notification) calls PlayerMagick's private address for every payment, refund and chargeback. Each call is signed with a passphrase that only you and PlayerMagick know (SHA512), so nobody else can send you fake sales.
PlayerMagick adds custom=… to your buttons' Digistore24 order form links. Digistore24 sends it back with the payment, so the match is exact. Upsells of the same order are matched through the order's first product when Digistore24 marks them as upsells, otherwise by the buyer's email. Rebills are shown as renewals.
Before you start
- You need a Digistore24 vendor account with at least one product.
- An IPN connection sends the products you tick. If another tool already has a connection, keep it: add a new one for PlayerMagick.
The quick way: Connect with Digistore24
When Connect with Digistore24 shows in the Connect dialog, PlayerMagick can set everything up for you:
- Go to Settings → Sales platforms and click Connect a platform.
- Next to Digistore24, click Connect, give the connection a name, then click Connect with Digistore24.
- Digistore24 opens and asks you to create an API key for PlayerMagick. Confirm it.
- You come back to PlayerMagick. It creates the IPN connection "PlayerMagick: {name}" in Digistore24 for all your products, with its own address and passphrase.
That's all: skip Steps 1 and 2 below and go to Step 3. If you change your mind in Digistore24, nothing is connected.
PlayerMagick keeps the API key sealed, like your passphrase. With it, PlayerMagick also updates the IPN connection when you regenerate the address, and removes it from Digistore24 when you remove the connection here.
Step 1: Connect Digistore24 in PlayerMagick
- Go to Settings → Sales platforms and click Connect a platform.
- Next to Digistore24, click Connect.
- Keep the suggested SHA512 passphrase (you paste it into Digistore24 in the next step), then click Connect.
- The setup page shows your receiver address. Copy it now: PlayerMagick shows it only once.
Step 2: Add the IPN connection in Digistore24
- In Digistore24, open Settings → Integrations (IPN) and click Add new connection.
- Choose the type Generic and tick your products (or All).
- Paste the receiver address as the IPN URL.
- In the SHA512 passphrase field, enter the same passphrase as in PlayerMagick.
- Set IPN timing to Before redirect to thankyou page and make sure Active is set to yes.
- Click Test connection. It should say "OK". Then save.
Already set up by hand? Let PlayerMagick do it
On the connection's setup page, paste a Digistore24 API key with full access into API key, save, then click Set it up in Digistore24 for me. PlayerMagick creates (or repairs) its IPN connection with a new address and passphrase. If Digistore24 refuses, nothing changes.
Step 3: Check it works
- Digistore24's Test connection appears on the setup page under Recent notifications as "Test received: never counted".
- Click Send a test sale in PlayerMagick. The result says what a real sale would be matched to. Test sales never count.
- Test orders you place in Digistore24's test mode show as tests and never count.
Keep the code on your checkout links
Point the player's buttons at your Digistore24 order form links (https://www.digistore24.com/product/…). PlayerMagick adds custom=… when the viewer clicks.
Digistore24 has only one custom field. If your link already uses custom (some membership tools do), PlayerMagick leaves it alone and adds ds24tr=… instead, which Digistore24 also sends back. If both are taken, those sales are matched by the buyer's email.
Troubleshooting
- Refused: the signature didn't match the saved secret. The passphrase in Digistore24 and in PlayerMagick differ. Copy the passphrase into the IPN connection again, or replace it in PlayerMagick with the one Digistore24 has.
- Test connection doesn't say "OK". Check that you pasted the whole address and that the connection is active.
- Ignored: event on_payment_missed (or another event). Digistore24 also sends missed payments, resumed rebills and new affiliates. They don't change your sales, so PlayerMagick only logs them.
- A rebill doesn't show as a sale. Rebills appear as renewals under Settings → Sales platforms, not as new sales of your video.
- Digistore24 isn't connected after Connect with Digistore24. The message says why: you didn't confirm the API key in Digistore24, it took longer than 15 minutes, or Digistore24 didn't accept the IPN connection. Start again, or set it up by hand with Steps 1 and 2.
- Digistore24 refused the API key or didn't answer (Set it up in Digistore24 for me). The key needs full access, not read-only. Create a new one, paste it into API key and try again.