Saltar al contenido
memberfy
AR

Transfere o meu ingresso para outra pessoa

POST/api/my/tickets/{ticketId}/transfer

Auth
Requiere token
Clave de API:
events:write
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

**Manda e-mail e não se desfaz.** O titular passa o próprio ingresso, por nome e e-mail, quando o evento permite (`transferEnabled` em `PATCH /api/events/{id}/ticket-settings`) e até a data limite (`transferDeadline`; sem ela, até o início do evento). O token e o código do ingresso mudam na hora (o QR antigo para de funcionar). Quem recebe e não é membro **entra na comunidade** (papel membro); recebe o e-mail "você recebeu um ingresso" com o QR e fica com o "Vou". Quem passou perde o "Vou" e as respostas de inscrição (o novo titular responde ao abrir o ingresso), e recebe a confirmação por e-mail com o convite de agenda de cancelamento. O pedido e o reembolso continuam do comprador; a equipe vê o histórico em `GET /api/events/{id}/ticket-transfers`. Sem limite de transferências dentro do prazo.

Ingresso que não é seu (ou de outra comunidade): 404. Opção desligada, prazo passado, check-in feito ou ingresso cancelado: 409 com o motivo (`tickets.transferDisabled`, `tickets.transferDeadlinePassed`, `tickets.transferCheckedIn`, `tickets.transferTicketCanceled`; `data.reason`). Só ingresso de pedido pago (`COMPLETED`) se transfere: cortesia, ingresso do plano e "Vou" gratuito dão 409 `tickets.transferNotTransferable` (`data.reason: notTransferable`). Duas transferências ao mesmo tempo do mesmo ingresso: a segunda dá 409 `tickets.transferInProgress` (`data.reason: inProgress`), antes de criar qualquer conta. Quem passou o ingresso não entra de novo pelo mesmo pedido (o "Vou" pago é recusado como para quem não comprou). Para si mesmo: 409 `tickets.transferToSelf`; para quem já tem ingresso do evento ou pediu para não ser convidado: 409 `tickets.transferRecipientUnavailable` (a mesma resposta para os dois). Comunidade com cadastro com aprovação e e-mail sem conta: 422 `tickets.assigneeNeedsApproval`. E-mail inválido: 422 `tickets.emailInvalid`.

Parámetros

NombreDóndeTipoDescripción
ticketIdobligatoriopathstring (uuid)

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Cuerpo de la solicitud application/json

NombreTipoDescripción
nameopcionalstringNome de quem recebe (para a conta nova) · max 200
emailobligatoriostring (email)max 320

Respuestas

CódigoDescripción
200A transferência.
401Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`).
404Recurso não encontrado.
409Conflito com o estado atual do recurso.
422E-mail inválido ou que precisa de cadastro aprovado.
500Erro interno do servidor.

Ejemplo con curl

curl -X POST "https://api.memberfy.net/api/my/tickets/<ticketId>/transfer" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'