Aller au contenu

Paga agora uma assinatura em atraso

POST/api/subscriptions/{id}/pay-now

Auth
Jeton requis
Qui peut l’appeler:
owner
admin
SuperAdmin
Clé d’API:
Clé d’API non acceptée
X-CommunityId
X-CommunityId Envoyez le X-CommunityId de la communauté où l’opération a lieu.
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.

"Pagar agora" (decisão do David, 2026-10-05). Gera, para a **mesma assinatura** em `PAST_DUE`, uma cobrança nova: PIX, boleto, cartão novo (`cardToken`) ou cartão salvo (`paymentMethodId`, do assinante). Os adicionais cobrados junto com o plano entram no mesmo pedido, com a taxa fixa uma vez. Paga (na hora, para cartão aprovado; ou pelo webhook), a assinatura volta a `ACTIVE`, o período avança e os adicionais suspensos voltam. O período pago é o que está em aberto, a partir de `nextBillingDate`; se ele já teria terminado, começa agora. Cobranças PIX/boleto de renovação ainda abertas da assinatura são canceladas antes, para não pagar duas vezes. Cartão novo usado aqui vira o cartão da próxima renovação. Quem pode: o assinante, ou owner/admin da comunidade do X-CommunityId (e SuperAdmin); assinatura de outra pessoa ou de outra comunidade responde 404. Recusas, todas antes de qualquer cobrança: 400 `param = id` quando a assinatura não está `PAST_DUE` ou é um adicional ligado a um plano; 400 `paymentMethod`/`installments` fora do que o produto aceita (parcelas só no cartão); 400 `cardToken` com cartão e sem token nem `paymentMethodId`; 404 `paymentMethodId` de cartão que não é do assinante; 409 `param = id` quando uma cobrança de cartão da assinatura ainda está em análise ou quando a pessoa foi removida da comunidade (perfil apagado: nunca é cobrada); 404 `param = X-CommunityId` (`community.notFound`) quando a comunidade foi excluída. Recusa do provedor responde 402; provedor fora do ar, 502. Responde 201. `data`: `subscriptionId`, `status`, `paid`, `pendingRenewal` (o mesmo objeto de `GET /api/subscriptions`, ou `null` quando já foi pago), `purchaseId`, `orderId`, `amount` (total do pedido), `currency`, `installments`, `periodStart`, `periodEnd` e `items` (`subscriptionId`, `productId`, `title`, `amount`). **Empresa:** o admin da empresa com vínculo vivo age como o assinante na assinatura da empresa (`companyId` na resposta); funcionário da empresa que não é admin recebe 403 (`monetization.company.adminOnly`); quem não tem relação com ela, 404.

Paramètres

NomEmplacementTypeDescription
idobligatoirepathstring (uuid)

En-têtes

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

Corps de la requête application/json

NomTypeDescription
paymentMethodobligatoireCREDIT_CARD | DEBIT_CARD | PIX | BOLETO
installmentsfacultatifintegerSó no cartão, até o maxInstallments do produto · ≥ 1, ≤ 12
paymentMethodIdfacultatifstring (uuid)Cartão salvo do assinante (/payment-methods)
cardTokenfacultatifstringCartão novo, tokenizado no app
customerDatafacultatifobjectNome, e-mail, documento e telefone do pagador, como no checkout. Sem ele, usa o cliente do pedido original

Réponses

StatutDescription
201Operação realizada com sucesso.
400Requisição inválida — falha de validação.
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`).
402Requisição inválida — falha de validação.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
409Conflito com o estado atual do recurso.
500Erro interno do servidor.

Exemple curl

curl -X POST "https://api.memberfy.net/api/subscriptions/<id>/pay-now" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"paymentMethod":"CREDIT_CARD"}'