> ## 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.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.dintero.com/feedback

```json
{
  "path": "/docs/loyalty/getting-started",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Getting started with Loyalty & Virtual Cards

> Connect your POS, ecommerce, and helpdesk apps to Dintero's Customer, Discount, Receipt, and Wallet services with a single API client.

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](mailto:support@dintero.com) if you don't have one.
* Access to [Backoffice](https://backoffice.dintero.com/) 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.

1. Log in to [Backoffice](https://backoffice.dintero.com/).
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.

| 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](/docs/loyalty/clients) for the full scope reference.

## Step 2: Authenticate

Exchange your client credentials for a bearer token:

```bash theme={null}
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:

```bash theme={null}
Authorization: Bearer <access_token>
```

Replace `T12345678` with your account ID. Use `T` prefix for test, `P` prefix for production.

See [Authentication service](/docs/loyalty/auth-service) for end-user login and single sign-on flows.

## Step 3: Choose your services

<CardGroup cols={2}>
  <Card title="Customers & Users" icon="user-group" href="/docs/loyalty/customer-service">
    Store customer profiles, link identifiers (phone, card token, membership number), and manage consents.
  </Card>

  <Card title="Discounts & Rewards" icon="percent" href="/docs/loyalty/discount-service">
    Configure loyalty programs, stamp cards, and coupons. Recalculate shopping carts before payment.
  </Card>

  <Card title="Receipts" icon="receipt" href="/docs/loyalty/receipt-service">
    Send receipts from POS or ecommerce and expose purchase history to customers or downstream systems.
  </Card>

  <Card title="Gift Cards" icon="gift" href="/docs/loyalty/wallet-create-gift-card">
    Create virtual gift cards with a balance and accept them in Dintero Checkout or your own payment flow.
  </Card>
</CardGroup>

## What's next

* [Set up webhooks](/docs/loyalty/webhooks) to receive real-time events when customers, discounts, receipts, or wallet transactions change.
* [API reference](/docs/loyalty/api-reference) for full endpoint documentation.