NuqtaPass

العربية

Loyalty program API for your POS or app

Add stamps, points or cashback from your own till or app, and the customer’s card in Apple Wallet or Google Wallet updates by itself.

What you can automate

  • Join: Open a card for a new customer from their phone number.
  • Stamps: Add a stamp after a sale, or undo the last one.
  • Points and cashback: Give points for the amount spent, with your shop’s rules.
  • Look up a customer: Find a card by its id or the customer’s phone, and read stamps, points and rewards.
  • Redeem: Give the reward when the card is full, or spend points.
  • The till API: Send paid orders and refunds, and stamps or points follow the shop’s card type. This is what the Odoo apps use.

API keys

  • The shop owner creates keys on the API keys page of the dashboard. A key is shown once.
  • Revoke a key any time. You can also give it an end date.
  • Each key works for its own shop only.
  • Send it in the Authorization header: Bearer sip_…

Three kinds of key

  • full: The whole API, for your till or app. Business plan
  • pos: Only the till API (/api/pos), for Odoo. Business plan
  • solver: Only Solver bills, for clinics. Any plan with the Solver add-on

One request: add a stamp

Every call sends the key as a bearer token and gets JSON back. The API docs list every endpoint with its parameters and an example.

curl -X POST https://sipcard-production-b91a.up.railway.app/api/stamp -H "Authorization: Bearer sip_…" -H "Content-Type: application/json" -d '{"cardId": "c7f1…"}'

Rate limits

Each endpoint has a limit per minute. A key on the till API can send 120 requests a minute. Past a limit the API answers 429: wait a minute and send again.

Business plan

API keys come with the Business plan. If the plan ends or moves down, the keys stop working until you move back. Clinics on Solver HMIS can use a Solver key on any plan with the add-on.

Frequently asked questions

How do I authenticate?

Create a key on the API keys page and send it in the Authorization header as Bearer sip_…, and the answers come back as JSON.

Which plan includes the API?

Business, from 35 OMR a month billed yearly (50 OMR month to month). Clinics can use a Solver key on any plan with the Solver add-on, for 12 OMR a month.

Can I connect Odoo without writing code?

Yes. Install the free NuqtaPass app for Odoo and paste a key. It uses the till API for you.

What if a key leaks?

Revoke it on the API keys page and create a new one for your till. Each key only reaches your own shop.

Is there a limit on requests?

Yes, a limit per minute on each endpoint. A till API key can send 120 requests a minute. Past a limit you get a 429 answer: wait a minute and send again.

Other integrations