Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dintero.com/llms.txt

Use this file to discover all available pages before exploring further.

The Dintero Loyalty & Virtual Cards platform gives you four services that share a single API and authentication model:
  • Customer service — centralize customer profiles, identifiers, and consents across all your apps
  • Discount & Reward service — create and redeem coupons, loyalty cards, stamp cards, and bonus points
  • Receipt service — store digital receipts from all sales channels and stream data to your systems via webhooks
  • Wallet service — issue and accept virtual gift cards online and in-store

​
Prerequisites

​
Step 1: Create an API client

Each application that accesses the API needs its own API client with the appropriate scopes.
  1. Log in to Backoffice.
  2. Go to Settings → API Clients → Create New API Client.
  3. Add the scopes your application needs.
Grant only the scopes each application requires. A POS that redeems discounts does not need write access to customer profiles.
ServiceAdmin scopeRead scopeWrite scope
Customeradmin:customersread:customerswrite:customers
Discountadmin:discountsread:discountswrite:discounts
Receiptadmin:receiptsread:receiptswrite:receipts
Walletadmin:walletsread:walletswrite:wallets
See API clients for the full scope reference.

​
Step 2: Authenticate

Exchange your client credentials for a bearer token: 
curl -X POST https://api.dintero.com/v1/accounts/T12345678/auth/token \
  -u "CLIENT_ID:CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"grant_type": "client_credentials", "audience": "https://api.dintero.com/v1/accounts/T12345678"}'
The response includes an access_token (JWT) valid for 4 hours. Pass it as a bearer token on all subsequent requests: 
Authorization: Bearer <access_token>
Replace T12345678 with your account ID. Use T prefix for test, P prefix for production. See Authentication service for end-user login and single sign-on flows.

​
Step 3: Choose your services

Customers & Users

Store customer profiles, link identifiers (phone, card token, membership number), and manage consents.

Discounts & Rewards

Configure loyalty programs, stamp cards, and coupons. Recalculate shopping carts before payment.

Receipts

Send receipts from POS or ecommerce and expose purchase history to customers or downstream systems.

Gift Cards

Create virtual gift cards with a balance and accept them in Dintero Checkout or your own payment flow.

​
What’s next

  • Set up webhooks to receive real-time events when customers, discounts, receipts, or wallet transactions change.
  • API reference for full endpoint documentation.
Last modified on May 11, 2026