Request and approve or decline a Nayax transaction refund via the Lynx API's two-step refund workflow.
domain: developerhub.nayax.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Look up the TransactionId and SiteId for the sale needing a refund using the Get Last Sales for Machine endpoint.
Submit a refund request with amount and reason via the Request Refund endpoint, which puts the transaction into Pending status.
Separately call the Approve or Decline Refund endpoint to finalize the request.
Monitor the transaction status for the Pending to Approved/Declined transition.
Expect the consumer to be notified by email automatically once the refund is approved or declined.
Known gotchas
Refunds only apply to credit card transactions — prepaid card purchases are explicitly excluded from this refund flow per Nayax docs.
Refund request and refund approval are two distinct API calls; requesting a refund does not itself release funds.
SWAP NOTE: no publicly documented Nayax remote-vend/dispense endpoint was found, so this route covers only the confirmed refund workflow rather than 'remote vend / refunds' as originally scoped.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?