Una API de tarjetas de regalo para tu próximo mercado
Lleva más de 5,000 marcas en más de 100 países a tu app, marketplace o programa de recompensas. Usa la misma API REST para consultar productos, crear pedidos y conciliar lo que gastas.
- Más de 5,000 marcas en más de 100 países
- Sandbox para probar antes del lanzamiento
- Pedidos y transacciones en una sola cuenta
Amplía tu catálogo sin gestionar cada proveedor
Tu equipo se integra una vez con GIFQ. Nosotros mantenemos las marcas, la disponibilidad por país y las denominaciones, para que añadir un mercado no requiera otra integración con un proveedor.
Tú controlas cuándo se crea el pedido y cómo aparece la recompensa en tu producto. GIFQ la entrega y permite consultar el estado y la transacción mediante la API.
Tu producto controla la experiencia. GIFQ entrega el pedido.
Una API de tarjetas de regalo conecta el suministro con un producto que tú controlas. Encaja cuando tu aplicación sabe qué marca, país e importe quiere el cliente y necesita comprar esa tarjeta dentro de su propio flujo.
| Parte del proceso | Tu aplicación | GIFQ |
|---|---|---|
| Selección del producto | Muestra productos adecuados y recoge la elección del cliente. | Proporciona datos del catálogo, incluidos países, monedas e importes disponibles. |
| Decisión de compra | Aplica tus reglas de aprobación y envía un pedido con una referencia única. | Valida el pedido y utiliza el saldo de la cuenta de empresa para la compra. |
| Entrega | Presenta el resultado en tu app o lo incorpora a tu proceso de entrega. | Obtiene el producto solicitado y deja disponibles los detalles de la entrega. |
| Conciliación | Relaciona el pedido con sus registros de clientes y financieros. | Proporciona el estado del pedido, los saldos y el registro de transacciones. |
Cómo funciona
Conecta con el sandbox
Usa tu encabezado X-Api-Token en api-sandbox.gifq.com. Prueba el catálogo, los pedidos y la gestión de errores antes de enviar pedidos reales.
Busca productos para tus mercados
Consulta GET /api/products para encontrar marcas, países, monedas y denominaciones disponibles. Selecciona productos que tus destinatarios puedan usar.
Crea el pedido
Envía el producto, importe, moneda y país a POST /api/orders. Añade tu propia referencia para relacionarlo con un usuario o una transacción de tu sistema.
Sigue y concilia los pedidos
Consulta cada pedido con GET /api/orders/:id. Usa /api/balances y /api/transactions para mantener sincronizados el saldo y tus registros de compras.
Construye el proceso de compra que necesitan tus clientes
Empieza con un producto y un mercado representativos en el entorno de pruebas y recorre el pedido completo. La integración debe contemplar qué ocurre antes de comprar y qué ve el cliente mientras la entrega sigue en curso.
Mantén un catálogo relevante
Usa los datos de país, moneda e importe para mostrar productos que tus clientes puedan canjear. Actualiza la disponibilidad en lugar de tratar una lista exportada como inventario permanente. Una marca global puede tener productos y condiciones distintos según el país; elegir la versión regional correcta importa tanto como el logotipo.
Asigna una referencia estable a cada compra
Mantén una referencia única en tu sistema y guarda junto a ella el identificador del pedido de GIFQ. Si una respuesta tarda, consulta el pedido existente antes de crear otra compra. La integración también debe respetar los límites de peticiones y decidir cómo mostrar los pedidos pendientes al cliente.
Conecta la operación diaria con tu producto
Los recursos para gestionar tus tarjetas de regalo
- Consulta productos y disponibilidad
/api/products - Crea y consulta pedidos
/api/orders - Consulta el saldo de la cuenta
/api/balances
Compra al volumen que necesites
Usa el mismo endpoint para compras individuales y tarjetas de regalo al por mayor. Tu integración gestiona la cola de pedidos, los límites de la API y los reintentos.
Mantén el catálogo actualizado
La API ofrece la disponibilidad y las denominaciones. Puedes añadir productos sin reconstruir la integración ni negociar un contrato con cada marca.
Concilia desde un solo registro
Los pedidos usan el mismo saldo y aparecen en el registro de transacciones. Tu equipo puede relacionarlos con sus propias referencias para generar informes.
Prueba el flujo completo
Usa el sandbox gratuito para revisar pedidos correctos y errores. Te ayudaremos a organizar el acceso y preparar la puesta en producción.
Una compra de tarjeta dentro de un marketplace
Un cliente elige en tu marketplace una tarjeta válida en su país. Tú mantienes el checkout y la relación con el cliente; la compra del producto pasa por GIFQ.
Confirma el producto
Tu aplicación encuentra el país, la moneda y el valor nominal necesarios en el catálogo. Aplica su propio precio y sus reglas de compra antes de enviar el pedido.
Crea y sigue el pedido
La solicitud incluye los detalles del producto y tu referencia. Tu sistema guarda el identificador y sigue el estado, sin confundir una solicitud aceptada con una entrega completada.
Entrega y concilia
Cuando se completa el pedido, tu flujo presenta los datos de la tarjeta. Finanzas puede relacionar la compra con la transacción de la cuenta y el pedido del cliente mediante las referencias guardadas.
Ejemplo ilustrativo de compra. Las condiciones, la disponibilidad y el precio al cliente dependen del mercado y de la configuración comercial.
Un registro de compra útil para finanzas y soporte
Una integración útil sigue cada pedido hasta un resultado claro. La financiación, la entrega y los reembolsos deben aparecer en la misma visión operativa para que soporte y finanzas trabajen con la misma información.
Lee el estado junto con las transacciones
Los pedidos pueden estar pendientes, completados, fallidos o reembolsados. Un pedido pendiente sigue en proceso de entrega; uno reembolsado tiene una devolución de fondos asociada. Usa el registro de transacciones al conciliar movimientos y mantén visibles las compras sin resolver hasta conocer el resultado final.
Usa la compra directa cuando conoces el producto
La compra directa conecta un producto conocido con un pedido financiado desde tu cuenta. Las tarifas y monedas del catálogo determinan su coste. Si sabes a quién pagar y cuánto, pero quieres que la persona elija después, GIFQ Send proporciona el flujo de elección del destinatario.
Prepara tu configuración
Revisa la cobertura, las tarifas y el trabajo necesario antes de empezar. Nuestro equipo te ayuda a resolver los detalles de tu programa.
¿En qué se diferencia de la API de un proveedor de tarjetas?
GIFQ reúne varios proveedores en una API de tarjetas de regalo. Tu integración utiliza un catálogo y un formato de pedido comunes, mientras nosotros gestionamos el suministro y la entrega. Así puedes acceder a más marcas y mercados desde una sola cuenta.
¿Puedo revender las tarjetas en lugar de regalarlas?
Sí. Los marketplaces y revendedores de e-pins pueden comprar tarjetas de regalo para reventa mediante la API. Los pedidos utilizan el mismo catálogo, saldo y registro de transacciones que las compras de recompensas.
¿Cómo se comparan con Tremendous?
Compara las marcas y países que necesitas, si vas a revender o enviar recompensas, y cómo funcionan las tarifas y los informes. GIFQ permite compras en volumen, reventa y pagos desde un mismo catálogo. Podemos compartir los productos y tarifas relevantes para que los compares con Tremendous según tu caso de uso.
¿Qué es una API de tarjetas de regalo?
Una API de tarjetas de regalo permite que tu software compre y entregue tarjetas. Con GIFQ, tu aplicación selecciona un producto y envía un pedido a POST /api/orders. Después puede consultar el resultado y seguir la transacción sin crear el pedido manualmente.
¿Puedo comprar tarjetas de regalo en volumen por la API?
Sí. Crea un pedido por tarjeta mediante POST /api/orders y procesa la cola respetando los límites de la API. Todos los pedidos usan el mismo saldo y aparecen en el mismo registro de transacciones.
¿Cuánto me va a tomar integrarla?
El plazo depende de tu flujo, los informes y la gestión de errores. Empieza por la autenticación, el catálogo y un pedido de prueba. Podemos revisar tu integración y ayudarte a definir qué debe estar listo antes del lanzamiento.
¿Hay sandbox?
Sí. El sandbox gratuito de api-sandbox.gifq.com permite probar antes de enviar pedidos reales. Contacta con nosotros para organizar el acceso y usa la referencia de la API para preparar tu integración de producción.
¿Qué marcas y países puedo vender realmente?
El catálogo incluye más de 5,000 marcas en más de 100 países, además de tarjetas prepago y suscripciones. Consulta GET /api/products para revisar disponibilidad, monedas y denominaciones en tus mercados.
¿Hay límites de solicitudes?
El límite estándar es de 10 solicitudes por segundo y por token. Las respuestas de listas están paginadas, con los detalles en los encabezados. Si tu volumen necesita otra configuración, consúltalo con nosotros antes del lanzamiento.
¿Tengo que escribir código?
Puedes crear pedidos desde el panel sin desarrollar una integración. Usa la API cuando los pedidos deban generarse automáticamente desde tu producto o conectarse a tus sistemas de informes.
¿Cuándo me conviene GIFQ Send en lugar de la API?
Usa la API de tarjetas de regalo cuando quieras pedir un producto concreto, como 500 tarjetas de Amazon. Usa GIFQ Send cuando quieras pagar a 500 personas y dejar que cada una elija su recompensa. Ambos productos pueden funcionar desde la misma cuenta.
Explora los otros productos
Empieza con tu primer pedido de prueba
Consulta la referencia de la API o cuéntanos tus mercados y tu flujo de pedidos. Te ayudaremos a comprobar la cobertura y acceder al sandbox.