---
title: "Receber evento de abertura de porta"
method: POST
path: "/api/v1/webhooks/partner-access"
tags: ["Webhooks"]
---

# Receber evento de abertura de porta

`POST /api/v1/webhooks/partner-access`

Webhook para o parceiro notificar um evento de abertura de porta (acesso).
O horário do acesso registrado é o valor de `timestamp` enviado no payload, não o horário de chegada na Beepay.
O endpoint é idempotente por `event_id`: reenviar um `event_id` já processado retorna 200 com o mesmo `id`.

## Request body

- object
  - `event_id` string, uuid, required — Identificador único do evento (UUID v4). Usado para idempotência.
  - `device_id` string, required — Código do dispositivo (dispositivos.codigo) que registrou o acesso.
  - `user_id` integer, required — ID do usuário que realizou o acesso.
  - `timestamp` string, date-time, required — Data/hora em que o acesso ocorreu. Não pode ser uma data futura.

## Response `200`

Evento já processado (idempotência) — retorna o log existente

- object
  - `id` integer

## Other responses

- `201` — Acesso registrado
- `401` — Unauthorized — token de parceiro ausente ou inválido
- `422` — Unprocessable Entity — falha de validação ou dispositivo não pertence ao mercado autenticado

---

[API](https://skmtc.dev/beepayapp/apis/beepay.md) · [All operations](https://skmtc.dev/beepayapp/apis/beepay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beepayapp/beepay/revisions/787a925e98a0/schema)