# Presto API Docs

> Integrate at the Speed of Presto. Presto is a super-app in Libya (food & shop delivery, rides, wallet). These docs cover the Vendor Integration API (for merchants syncing catalogs and handling orders) and the Financial Institutions (FI) Integration API (for banks and payment providers handling wallet top-ups and driver settlements).

Every page is also available as Markdown by appending `.md` to its URL. The full documentation in a single file is at https://integration.presto.app/llms-full.txt.

For support or API credentials, contact support@presto.app.

## Vendor Integration API

- [Getting Started](https://integration.presto.app/docs/vendor-integration-api/getting-started.md): This guide provides a quick overview of the Presto Vendor Integration API and how to start integrating with it.

## Vendor Integration API › API Endpoints

API endpoints for the Vendor Integration API.

- [Authentication & Security](https://integration.presto.app/docs/vendor-integration-api/Endpoints/authentication.md): Proper authentication is required for all API calls to the Presto Vendor Integration API.
- [Webhook Events](https://integration.presto.app/docs/vendor-integration-api/Endpoints/webhook-events.md)
- [Miscellaneous](https://integration.presto.app/docs/vendor-integration-api/Endpoints/miscellaneous.md)

## Vendor Integration API › API Endpoints › Catalog Management

Endpoints related to managing your product catalog.

- [Catalog Management Overview](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Catalog/catalog-overview.md): This document provides a comprehensive overview of the catalog management process in the Presto Vendor Integration API. The catalog management functionality allows vendors to create, update, and manage their products within the Presto platform.
- [Categories](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Catalog/categories.md): Retrieve a list of all available item categories and subcategories within the Presto system.
- [Brands](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Catalog/brands.md): Retrieve a list of all available item brands within the Presto system.
- [Create or Update Items](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Catalog/manage-items.md): This endpoint allows vendors to create new items or update existing ones in bulk. Items are matched based on the vendorreferenceid.
- [Item Availability](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Catalog/item-availability.md): This endpoint allows vendors to update the availability status and stock quantity for multiple items in bulk.
- [List Items](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Catalog/list-items.md): This endpoint allows vendors to retrieve their catalog items with pagination support.
- [Attribute Values](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Catalog/attribute_value.md): Retrieve a list of all available variant attributes and their possible values within the Presto system.

## Vendor Integration API › API Endpoints › Order Management

Endpoints for managing the order lifecycle.

- [Order Management Overview](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Order/order-overview.md): This document provides a comprehensive overview of the order management process in the Presto Vendor Integration API.
- [Get Order Details](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Order/get-order-details.md): This endpoint allows vendors to retrieve the current details and status of a specific order.
- [Accept Order](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Order/accept-order.md): This endpoint allows vendors to acknowledge and accept an incoming order in the Presto system.
- [Reject Order](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Order/reject-order.md): This endpoint allows vendors to reject an incoming order that they cannot fulfill.
- [Ready Order](https://integration.presto.app/docs/vendor-integration-api/Endpoints/Order/ready-order.md): This endpoint allows vendors to mark an accepted order as prepared and ready for pickup or dispatch.

## FI Integration API

- [Getting Started](https://integration.presto.app/docs/fi-integration-api/getting-started.md): This guide provides a quick overview of the Presto Financial Institutions API and how to start integrating with it.

## FI Integration API › Authentication

Authentication overview

- [Overview](https://integration.presto.app/docs/fi-integration-api/Auth/authorization-overview.md): Proper authentication is required for all API calls to the Presto Financial Institutions API.
- [Issue Token](https://integration.presto.app/docs/fi-integration-api/Auth/issue-token.md): This endpoint allows you to generate an authentication token for accessing the Presto API and returns the necessary information to authenticate your API requests.
- [Password Reset](https://integration.presto.app/docs/fi-integration-api/Auth/password-reset.md): This endpoint allows you to reset the password for your account by providing your email and current password along with the new password.

## FI Integration API › Wallet Topup

Endpoint for Wallet Topup

- [Overview](https://integration.presto.app/docs/fi-integration-api/Wallet%20Topup/wallet-topup-overview.md): This document provides a comprehensive overview of the wallet top-up process in the Presto Financial Institutions API. The wallet top-up functionality allows financial institutions to credit funds to their customers' Presto wallets.
- [Transaction Initialization](https://integration.presto.app/docs/fi-integration-api/Wallet%20Topup/wallet-init.md): This endpoint verifies that a customer exists in the Presto system and returns the necessary information to present a confirmation prompt to your users.
- [Transaction Confirmation](https://integration.presto.app/docs/fi-integration-api/Wallet%20Topup/wallet-confirm.md): The confirmation endpoint is used to finalize a wallet top-up transaction after customer confirmation.
- [Transaction Status](https://integration.presto.app/docs/fi-integration-api/Wallet%20Topup/transaction-info.md): Retrieve information about a specific transaction using its reference ID.
- [Transactions List](https://integration.presto.app/docs/fi-integration-api/Wallet%20Topup/transactions-list.md): Retrieve a list of your institution's wallet top-up transactions, newest first.

## FI Integration API › Driver Settlements

Endpoints for settling driver debt (Cash In) and paying out driver earnings (Cash Out).

- [Overview](https://integration.presto.app/docs/fi-integration-api/Driver%20Settlements/driver-settlements-overview.md): The Driver Settlements API lets a partner financial institution act as a cash counter for Presto drivers, in both directions.
- [Driver Lookup](https://integration.presto.app/docs/fi-integration-api/Driver%20Settlements/driver-lookup.md): Resolve a Presto driver from an identifier and read the two balances that drive the Cash In and Cash Out operations.
- [Cash In — Initialization](https://integration.presto.app/docs/fi-integration-api/Driver%20Settlements/cash-in-init.md): Start a debt settlement: the driver hands cash to the institution, and Presto reduces the driver's outstanding debt by that amount.
- [Cash In — Confirmation](https://integration.presto.app/docs/fi-integration-api/Driver%20Settlements/cash-in-confirm.md): Finalize a debt settlement. Presto reduces the driver's outstanding debt and records the institution as the collecting party.
- [Cash Out — Initialization](https://integration.presto.app/docs/fi-integration-api/Driver%20Settlements/cash-out-init.md): Start an earnings payout: the institution hands cash to the driver, and Presto reduces the driver's available earnings by that amount.
- [Cash Out — Confirmation](https://integration.presto.app/docs/fi-integration-api/Driver%20Settlements/cash-out-confirm.md): Finalize an earnings payout. Presto debits the driver's available earnings and records the institution as the paying party.
- [Transaction Status](https://integration.presto.app/docs/fi-integration-api/Driver%20Settlements/transaction-info.md): Retrieve the current state of any Cash In or Cash Out transaction by its reference.