Loyalty & Virtual Cards - Dintero Documentation

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

A Dintero account. Contact support@dintero.com if you don’t have one.
Access to Backoffice to create API clients.

Step 1: Create an API client

Each application that accesses the API needs its own API client with the appropriate scopes.

Log in to Backoffice.
Go to Settings → API Clients → Create New API Client.
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.

Service	Admin scope	Read scope	Write scope
Customer	`admin:customers`	`read:customers`	`write:customers`
Discount	`admin:discounts`	`read:discounts`	`write:discounts`
Receipt	`admin:receipts`	`read:receipts`	`write:receipts`
Wallet	`admin:wallets`	`read:wallets`	`write: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 sandbox, 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.

https://mintcdn.com/dintero-c3a7bfec/WW-UMjl-QNnroAqd/mintlify-docs/assets/icons/receipt-tax.svg?fit=max&auto=format&n=WW-UMjl-QNnroAqd&q=85&s=cea2fb2b6367fc66e14f75c1a5bdc491

Receipts

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

https://mintcdn.com/dintero-c3a7bfec/WW-UMjl-QNnroAqd/mintlify-docs/assets/icons/gift.svg?fit=max&auto=format&n=WW-UMjl-QNnroAqd&q=85&s=ff2235fc45f0a12ca8d500ad40ca87d1

Gift Cards

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

​Prerequisites

​Step 1: Create an API client

​Step 2: Authenticate

​Step 3: Choose your services