Zum Inhalt springen

Adiciona um adicional ao plano, sem cobrar agora (equipe)

POST/api/manage/subscriptions/{subscriptionId}/add-ons

Auth
Token erforderlich
Wer darf:
owner
admin
finance
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.

F-45. Owner, admin ou finance; auditado. `productId` precisa ser um adicional da lista do plano, vendido junto (F-33/F-37), que o membro ainda não tenha. O resto do período atual sai sem custo; a partir da próxima renovação o adicional é cobrado junto com o plano. Nada é cobrado agora. A resposta traz `addOnSubscriptionId`.

Parameter

NameOrtTypBeschreibung
subscriptionIdPflichtpathstring (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
productIdPflichtstring (uuid)

Antworten

StatusBeschreibung
200Detalhe depois da ação.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
409A assinatura não está ativa.
500Erro interno do servidor.

curl-Beispiel

curl -X POST "https://api.memberfy.net/api/manage/subscriptions/<subscriptionId>/add-ons" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"productId":"00000000-0000-0000-0000-000000000000"}'