Docs

Gift Cards · Reference

Gift Cards API

Monato's Giftcards API · version 1.0.0. 2 endpoints, generated from the OpenAPI spec.

2endpoints in 1 group
Bearer tokenauthentication
https://dev-api.finco.latbase URL

Overview

Monato Giftcards API provides endpoints for selling digital gift cards (eGift) through Monato's payment platform.

This API is designed to be Developer/AI-first, providing comprehensive documentation for easy integration in any programming language. All endpoints require Bearer token authentication.

Key Features:

  • Purchase gift cards (generate an eGift) with an idempotency key to prevent duplicates

Discovering available gift cards:

  • The list of available gift cards is exposed through the Billpay API. Query the List Payees endpoint and filter those whose category is Giftcard.
  • Each such payee's id is the payee_id you use to purchase a gift card here.

Important Notes:

  • Discover available gift cards from the Billpay payees with category Giftcard before purchasing.
  • Gift card products are not updated very often, so cache the payees list (category Giftcard) on your application server for at least 7 days.
  • The payee_id is the id of the service (gift card product) being purchased.
  • All amounts are processed in MXN (Mexican Pesos) and must fall within the product's allowed range.
  • An idempotency_key is required on every purchase to prevent duplicate transactions.

Servers

URLDescription
https://dev-api.finco.lat

Authentication

BearerAuthBearer token· format Access Token· used by 2 endpoints

Postman collection

Monato · Gift Cards2 requests, generated from this spec

Endpoints

GET/api/v1/payees
List gift card payees
POST/api/v1/gift_cards
Purchase a gift card (generate an eGift)