# TuniMobile Integration API

> Sell TuniMobile recharge vouchers (Tunisie Telecom, Orange, Ooredoo) from your own application.

- [Introduction](https://docs.tunimobile.com/index.md): Sell TuniMobile recharge vouchers from your own application.
- [Quickstart](https://docs.tunimobile.com/quickstart.md): The typical call sequence: start the app, sell a voucher, close the shift.
- [Requests and responses](https://docs.tunimobile.com/basics/requests-and-responses.md): Base URL, request format and the response envelope.
- [Authentication](https://docs.tunimobile.com/basics/authentication.md): JWT access and refresh tokens delivered as cookies.
- [Terminal API key](https://docs.tunimobile.com/basics/terminal-api-key.md): Identify each printing device, and see which credential each endpoint needs.
- [Log in](https://docs.tunimobile.com/api/auth/login.md): Log the user in and set the BEARER and refresh_token cookies.
- [Refresh the session](https://docs.tunimobile.com/api/auth/refresh.md): Get a new access token using the refresh_token cookie.
- [Log out](https://docs.tunimobile.com/api/auth/logout.md): Expire the session cookies.
- [Get the profile](https://docs.tunimobile.com/api/account/profile.md): Read the logged-in shop's profile, prices and verification state.
- [Get the balance](https://docs.tunimobile.com/api/account/balance.md): Read the shop's current balance.
- [Register / check the terminal](https://docs.tunimobile.com/api/terminal/register.md): Register the device as a terminal, or fetch it if it already exists.
- [Generate a voucher](https://docs.tunimobile.com/api/vouchers/generate.md): Sell a voucher: reserve it for this terminal and debit the shop balance.
- [Confirm a printed voucher](https://docs.tunimobile.com/api/vouchers/confirm.md): Mark a voucher as confirmed once the ticket is printed.
- [Reprint an unconfirmed voucher](https://docs.tunimobile.com/api/vouchers/reprint.md): Get the same voucher again when the ticket did not print. No new debit.
- [Print a duplicate of a confirmed voucher](https://docs.tunimobile.com/api/vouchers/duplicate.md): Print a copy of a confirmed voucher. No new debit.
- [Confirm a reprint or duplicate](https://docs.tunimobile.com/api/vouchers/confirm-reprint.md): Mark a voucher as confirmed after a reprint or duplicate was printed.
- [List the voucher history](https://docs.tunimobile.com/api/vouchers/history.md): Paginated list of vouchers sold by the shop's terminals.
- [Open / close a sales session](https://docs.tunimobile.com/api/sessions/rotate.md): Close the terminal's current session, get its summary, and open a new one.
- [Voucher statuses](https://docs.tunimobile.com/reference/voucher-statuses.md): The lifecycle of a sold voucher.
- [Errors](https://docs.tunimobile.com/reference/errors.md): HTTP status codes and how to show errors to users.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.