Visitas

Un registro de visita sin ticket, para programas de sellos y de visitas.

POST/v1/visits

Permiso: transactions:write o devices:write

Registra una visita y otorga la recompensa por visita del programa. Devuelve un objeto similar a una transacción, con object: "visit" y amount: 0. Si repites un external_id, recibes la visita guardada con 200. Los programas de cashback responden 400 visit_not_supported.

external_idstring, obligatorio: Tu id de este registro. Comparte el espacio de nombres con las transacciones.
memberstring, obligatorio: Cualquier dato que identifique al socio, incluido el valor sin procesar de un escáner.
device_idstring: El dispositivo que lo registró. En los informes aparece como la caja.
visited_atdatetime: Cuándo ocurrió. Por defecto, ahora.

Parámetro	Tipo	Descripción
external_id	string, obligatorio	Tu id de este registro. Comparte el espacio de nombres con las transacciones.
member	string, obligatorio	Cualquier dato que identifique al socio, incluido el valor sin procesar de un escáner.
device_id	string	El dispositivo que lo registró. En los informes aparece como la caja.
visited_at	datetime	Cuándo ocurrió. Por defecto, ahora.

curl

curl https://loyaltyfy.io/api/v1/visits \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "door-1-2026-10-06-0042",
    "member": "4285324286429",
    "device_id": "door-1"
  }'

Respuesta · 201

{
  "object": "visit",
  "id": "feb2ad75-ac7b-4bb6-8b64-192323b7f6ea",
  "external_id": "door-1-2026-10-06-0042",
  "status": "completed",
  "amount": 0,
  "stamps_earned": 1,
  "reward_unlocked": false,
  "register_id": "door-1",
  "livemode": false,
  "created_at": "2026-10-06T18:17:28.209+00:00",
  "member": {
    "object": "member",
    "card_number": "4285324286429",
    "stamps": { "current": 2, "required": 5, "rewards_available": 0 },
    ...
  },
  ...
}

Una visita se puede anular como un ticket: POST /v1/transactions/{external_id}/void.