GIFQ API· Para desarrolladores
Una API de tarjetas de regalo para 5,000+ marcas en 90+ países
Quieres que tu app le entregue a alguien una tarjeta de regalo. Sin nosotros, eso es una cuenta con Amazon, otra con Starbucks, otra con la marca que importa en México - cada una con su propia API, su propia idea de qué es un "producto" y su propia manera de avisarte que algo se rompió. Con nosotros es un solo POST, y es la misma llamada para una tarjeta que para diez mil.
Un endpoint, todas las marcas
Sandbox gratis - construye antes de pagar nada
Valor nominal. No inflamos el precio de las tarjetas
Ya funcionan sobre GIFQ
Cada marca tiene su propia API, y ningún catálogo coincide
Operamos tarjetas de regalo durante años antes de construir esto. Cada marca tenía su propia integración, su propia idea de qué era un producto y su propio calendario de caídas. Cuando una tarjeta no llegaba, casi siempre nos enterábamos por el cliente antes que por nuestros propios sistemas.
Agregar una marca era un contrato, un sandbox y dos semanas. Agregar un país era repetirlo todo, muchas veces en un idioma que nadie del equipo hablaba. GIFQ es la integración que queríamos que existiera - una que cubre todo, para que nadie tenga que volver a hacer eso.
Cómo funciona
1
Consigue un token
Cada solicitud lleva un encabezado X-Api-Token. Apúntalo a api-sandbox.gifq.com y puedes construir la integración completa antes de gastar un centavo.
2
Pregunta qué puedes vender de verdad
GET /api/products te devuelve las marcas que funcionan en el país que te interesa - no una lista global que tienes que filtrar tú mismo esperando no equivocarte.
3
Ordena la tarjeta
POST /api/orders con marca, monto, moneda y país. Adjunta tu propia referencia y la orden queda rastreable desde tu lado igual que desde el nuestro.
4
Entérate de qué pasó
GET /api/orders/:id para saber en qué va. /api/balances para lo que queda. /api/transactions para cada orden que has colocado, que es la que finanzas te va a pedir.
Lo que eso te compra en la práctica
Diez tarjetas o diez mil, la misma llamada
No hay formato de lote que aprender ni contrato aparte para volumen. Haces un loop. Ordenar a escala es una propiedad de tu código, no un producto distinto con su propio papeleo.
Agregar una marca no te cuesta nada
Quién está disponible, en qué país, en qué denominaciones - mantener eso al día es nuestro trabajo. Cuando alguien pida una marca más el próximo trimestre, no renegocias nada. Simplemente empiezas a pedirla.
Un saldo, un libro contable
Cada orden descuenta del mismo saldo y cae en la misma lista de transacciones. Cuando finanzas pregunte qué gastaste el mes pasado, eso es una consulta, no una carpeta de PDFs de once proveedores.
Rómpelo primero en el sandbox
api-sandbox.gifq.com se comporta como producción y no cuesta nada. Prueba ahí tu manejo de errores en serio - los bugs interesantes solo aparecen cuando una tarjeta falla, y es mejor conocerlos ahí.
Primero revisa las 5,000+ marcas
Antes de hablar con nadie, confirma que tenemos lo que tu gente quiere, en los mercados que te importan. Te enviamos el catálogo completo.
Preguntas frecuentes
El resto de la plataforma
Cada línea corre sobre el mismo catálogo, saldo y libro contable, así que sumar otra después no significa empezar de cero.
Ve y lee la documentación
El sandbox es gratis y la referencia es pública, así que puedes averiguar si esto te sirve antes de hablar con nadie. Si prefieres preguntarle primero a una persona, eso también funciona.