Skip to content

Revenue sources

A revenue source connects a website or shop you run to Finance. Every sale it reports becomes an income entry in your ledger, and the buyer is matched to a CRM contact or added as a new one. You can also log costs against a source, such as its ad spend, so each source shows its own profit.

Plan
Pro and Business

You choose one of two integration modes when you create a source:

ModeHow sales reach PinlyxBest for
PushYour site sends each sale to an ingest URL, signed with an ingest key, the moment it happens.Checkout pages you control.
PullPinlyx calls a feed URL on your site on a schedule and reads new sales from it.Sites that can expose a read-only endpoint.

Each sale carries your own unique id (externalId). Sending the same id again updates that row instead of adding a second one, which is how a refund or a status change is recorded. Only three fields are required: externalId, amount and occurredAt. The rest (status, currency, customer details, product, quantity, tax, fee, payment method and more) are listed in the Field reference on the source’s Setup tab.

If you connect a Shopify, WooCommerce or ikas store, Pinlyx creates a revenue source named after the store for you. You do not need to set one up by hand.

  1. Go to Finance › Revenue sources and click New source.
  2. Enter a Name, for example your shop’s domain, pick a Default currency and, optionally, a Category for its income.
  3. Click Next, choose Push as the Integration mode and click Create source.
  4. On the source page, click Generate key. Copy the token, tick I have stored this token safely and click Done. The full token is shown only this once.
  5. Open the Setup tab. It has the ingest URL, a ready-made snippet in PHP, cURL or Node.js, and the full field contract.
  6. Add the call to your site so it posts each sale when it completes. The source status changes to Live once the first sale arrives.
  1. Click New source, enter a Name and a Default currency, then click Next.
  2. Choose Pull as the Integration mode.
  3. Enter the Feed URL. It must be a public HTTPS endpoint that returns the revenue event format shown under Feed format on the Setup tab.
  4. Under Auth, choose None, Bearer token or Custom header, and enter the secret if you need one. It is stored encrypted and never shown again.
  5. Set Check every to how often Pinlyx should read the feed, in minutes.
  6. Click Create source, then use Test connection on the Setup tab to check that the feed answers.

If your feed returns a nextCursor, Pinlyx sends it back as ?cursor= on the next call, so each sync only reads what is new.

The list shows each source with its mode, the number of sales received and when the last one arrived. Its status tells you what to do next:

StatusMeaning
Live / SyncedSales are arriving (push) or the last sync succeeded (pull).
Waiting for salesConnected, nothing received yet.
No key yetA push source without an ingest key. Generate one.
Not synced yetA pull source that has not run yet.
Sync failedThe last pull failed. The source page shows when.
DisabledNew sales are rejected.

Use the Needs attention tab to list only the sources that need action. Open a source to see its tabs:

  • Overview: Revenue, Expenses and Net profit for the source, a Profit and loss chart and the latest sales.
  • Sales: every sale received, newest first.
  • Expenses: costs counted against this source. Click Add expense to log one, for example ad spend. It also lands in your ledger.
  • Setup: connection details, code samples, the field reference and the feed format.
  • Activity: every push or scheduled pull, with what was accepted, skipped as a duplicate or rejected.
  • A sale with status refunded or failed stays in the ledger but is left out of realized totals.
  • Your site can also log a cost with "type": "expense" on the same endpoint. A day where expenses beat income shows as a loss.
  • The same ingest token can read back, correct and delete what you sent, and manage categories. Call those endpoints from your server only, never from a browser.
  • Rotate ingest key replaces the token. The old one stops working immediately.
  • Disable and Disconnect both stop new sales from being accepted. Revenue already imported stays in your ledger.
  • A pull source is checked every 5 to 1440 minutes.
  • How many revenue sources you can connect depends on your plan. See Plans and limits.