For brands

Postback integration

A postback is a server-to-server ping you send Adryse whenever a sale, lead, or signup happens. It’s how Adryse attributes the event to the publisher who drove the click.

How it works

When a visitor clicks a publisher’s Adryse link, we redirect them to your site and append a click_id parameter to the URL. Capture that click_id on landing (cookie, session, hidden form field — your choice) and send it back to us with the order details when the visitor converts.

Postbacks are GET or POST requests to a URL we generate per brand. No SDK, no client-side JS, no cookies on Adryse’s side. Works from any backend that can make an HTTP request.

Step 1 — Capture the click ID

Adryse appends ?click_id=clk_... to your landing URL. Persist it for the duration of the user’s session — typically in a first-party cookie that lives at least as long as your checkout flow.

// Example: landing page handler
const clickId = url.searchParams.get("click_id");
if (clickId) {
  response.cookies.set("adryse_click", clickId, {
    maxAge: 60 * 60 * 24 * 30, // 30 days
    httpOnly: true,
    sameSite: "lax",
  });
}

Step 2 — Fire the postback on conversion

From your order-confirmation handler (or webhook), call the postback URL with the order reference, value, and the captured click ID. Find your unique postback URL in Dashboard → Settings → Postback.

GET https://track.adryse.net/p/{YOUR_TOKEN}
  ?order=ORDER-12345
  &value=4999
  &click_id=clk_01HXY...
  &status=new

Required parameters

order — your internal order reference. Used for deduplication; sending the same order twice is idempotent.
value — order value in the smallest currency unit (cents, öre, pence). 4999 means €49.99.

Optional parameters

click_id — the captured Adryse click ID. Strongly recommended; without it we fall back to last-valid-click within the attribution window, which is less precise.
status — new (default, pending), approved, cancelled, reversed, or partial. See the billing guide for the full lifecycle.
value_format=currency — send value in full units instead of cents (e.g. 49.99).
currency — three-letter ISO code if the order is not in your account’s default currency.

Step 3 — Confirm or reverse conversions

New conversions land in pending for a hold period (default 14 days) so you can review for fraud, returns, or cancellations. Reversals must happen during this window — once a conversion auto-approves (or you explicitly approve it), it’s locked and cannot be reversed via postback. To finalise earlier, send a follow-up postback with the same order and status=approved:

GET https://track.adryse.net/p/{YOUR_TOKEN}
  ?order=ORDER-12345
  &status=approved

To reverse a conversion (return, fraud, chargeback) send status=reversed or status=cancelled. To adjust the order value after a partial return, send status=partial with the new value.

Status reference

Status sent	Result
`new` (or empty)	Creates a pending conversion
`approved`	Marks the conversion approved — commission locks in
`cancelled` / `reversed` / `denied`	Reverses the conversion and refunds the held balance. Only allowed while the conversion is pending.
`partial`	Recalculates commission on the new lower order value

Testing your integration

Before going live, fire a postback against your token with a test order ref like TEST-001. The conversion should appear in Dashboard → Conversions within seconds. Reject it from the dashboard and re-fire to confirm the round trip works.

Need help?

Email [email protected] with your brand name and a sample order reference and we’ll trace it end-to-end.