Integración de desarrolladores
El 7stamp Integration API permite administrar una CRM, una plataforma de comercio electrónico, un POS, un backend personalizado o una herramienta de automatización Tarjetas de fidelización de billetera con el identificador de contacto que su propio sistema ya utiliza. Es la opción universal cuando no existe una integración especializada.
La API base URL es https://api.7loc.com/cards-api. Autentica cada solicitud con una clave API como un token Bearer. Utilice la referencia OpenAPI vinculada para los esquemas de solicitud y respuesta en vivo antes de crear la lógica de producción.
El API es el lado de escritura de la pila de integración. Úselo siempre que su propio software deba seguir siendo la fuente operativa de verdad mientras 7stamp maneja la capa de lealtad de la billetera.
Genere un enlace de tarjeta de billetera personal para cualquier cliente en su sistema. Envíelo a través de su propio correo electrónico, SMS, push o flujo dentro de la aplicación. El cliente abre el enlace y guarda la tarjeta en Apple Wallet o Google Wallet.
Cuando se cierra una compra en su POS personalizado, cuando se paga un pedido en línea en su sitio web o cuando se completa un servicio en su sistema de reservas, llame al API para acreditar los sellos. La tarjeta se actualiza en segundos.
Emitir un vale único para un cliente específico, crear flujos de recompensa listos para la campaña y recuperar el estado del vale en los sistemas que manejan las finanzas y la calidad del servicio.
Estas son las rutas públicas API detrás de Acciones Make y Zapier. Lea el esquema exacto en la referencia API; no infiera nombres de campos desde un punto final diferente.
POST /cards/invite Crea una nueva instalación personal URL para un contacto externo.
POST /cards/invite/bulk Crea hasta 100 enlaces de invitación en un lote controlado.
GET /cards Busca registros de tarjetas por identificador de contacto externo.
GET /cards/{user_card_id} Devuelve el estado completo de una tarjeta por su 7stamp ID interno.
POST /cards/scan Agrega sellos por tarjeta ID o External ID y registra el pedido de origen cuando se suministra.
GET /templates Enumera las plantillas de tarjetas disponibles para el lugar de trabajo de la clave/profile.
GET /templates/{template_id}/design Lee la configuración visual de un plantilla de tarjeta conocida.
POST /vouchers/issue Emite un vale al titular de una tarjeta.
POST /messages/send Envía contenido de correo electrónico push de tarjeta de billetera y/or al propietario de una tarjeta.
Estas son pantallas 7stamp Admin reales. Abra API e Integraciones, agregue una clave y luego cópiela en una conexión segura secreta del lado del servidor o de automatización.
Cree la clave en 7stamp Admin en API Integrations → API Keys → Add API Key. Una clave pertenece a un lugar de trabajo/profile, así que cree claves separadas para desarrollo y producción cuando la configuración de su cuenta lo permita. Rote o revoque el acceso desde el panel si se expone un secreto.
External ID es el identificador de contacto estable de su sistema: un CRM ID, cliente UUID, número de teléfono o correo electrónico. Prefiere un sistema inmutable ID. Opcionalmente, agregue External Source para evitar colisiones entre sistemas y hacer explícita la correlación de webhooks.
Cuando el perfil tiene una plantilla activa, template_id se puede omitir y 7stamp la selecciona automáticamente. Cuando tenga varias plantillas activas, pase el template_id previsto. Lea GET /templates primero en lugar de codificar un ID adivinado.
bash curl -X POST "https://api.7loc.com/cards-api/cards/invite" \
-H "Authorization: Bearer YOUR_7STAMP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}'Inicie sesión en 7stamp Admin y cree una clave: API Integrations → API Keys → Add API Key. Guárdelo en su administrador secreto, no en el código fuente ni en una aplicación del lado del cliente.
Establezca la base URL en https://api.7loc.com/cards-api y agregue Authorization: Bearer seguido de la clave para cada solicitud del lado del servidor.
Llame primero al GET /templates. Una respuesta exitosa confirma el token y muestra las plantillas disponibles para ese lugar de trabajo/profile.
Elija el External ID estable y el External Source opcional de su propio sistema. Utilice exactamente el mismo par de identidades en la lógica de creación, escaneo, búsqueda y webhook.
Llame al POST /cards/invite con un contacto de prueba desechable. Verifique la instalación devuelta URL antes de automatizar la entrega a clientes reales.
Agregue POST /cards/scan, vales o acciones de mensaje solo después de tener una estrategia de registro, manejo de errores y reintento seguro/idempotency en su propio backend.
La referencia pública Swagger/OpenAPI contiene los esquemas actuales de punto final, parámetro, cuerpo de solicitud, respuesta y webhook. El URL interactivo es https://api.7loc.com/cards-api/docs y el contrato legible por máquina es https://api.7loc.com/cards-api/openapi.json. Léalo antes de implementar el manejo de errores o agregar campos opcionales.
La clave es un secreto del lado del servidor. No lo exponga en JavaScript del navegador, un paquete de aplicaciones móviles, un formulario público, capturas de pantalla, campos de texto Make/Zapier ni tickets de soporte. Utilice un servidor, una conexión de automatización segura o un administrador secreto. Si alguna vez la clave se comparte accidentalmente, revocarla o rotarla en 7stamp Admin y actualizar la conexión afectada.
En 7stamp Admin, vaya a API Integrations → API Keys → Add API Key. Luego, el token se envía en el encabezado Authorization como Bearer seguido de la clave.
Utilice https://api.7loc.com/cards-api y envíe Authorization: Bearer YOUR_7STAMP_API_KEY en cada solicitud autorizada.
Solo cuando el perfil conectado tiene exactamente una plantilla de tarjeta activa. Si hay varias plantillas activas, seleccione la template_id correcta entre GET /templates.
Utilice API para un POS personalizado, backend, sitio o control total. Utilice Make para escenarios de ramificación visual. Utilice Zapier para un flujo de trabajo de acción de activación mayoritariamente lineal. Los tres se basan en la misma clave API y el mismo contrato API.
Páginas relacionadas
Siguiente paso
Cree la clave, llame al GET /templates, cree una invitación para un contacto desechable y luego agregue secretos de producción, registros, reintentos y manejo de webhooks en torno a la solicitud probada.