Zum Inhalt springen
memberfy
AT

Transfere o meu ingresso para outra pessoa

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

Auth
Token erforderlich
API-Schlüssel:
events:write
X-CommunityId
X-CommunityId Sende die X-CommunityId der Community, in der die Operation stattfindet.
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.

**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`.

Parameter

NameOrtTypBeschreibung
ticketIdPflichtpathstring (uuid)

Header

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

Request-Body application/json

NameTypBeschreibung
nameoptionalstringNome de quem recebe (para a conta nova) · max 200
emailPflichtstring (email)max 320

Antworten

StatusBeschreibung
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.

curl-Beispiel

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]"}'