Zum Inhalt springen

Paga agora uma assinatura em atraso

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

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

"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 (F-37) 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. 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`).

Parameter

NameOrtTypBeschreibung
idPflichtpathstring (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
paymentMethodPflichtCREDIT_CARD | DEBIT_CARD | PIX | BOLETO
installmentsoptionalintegerSó no cartão, até o maxInstallments do produto · ≥ 1, ≤ 12
paymentMethodIdoptionalstring (uuid)Cartão salvo do assinante (/payment-methods)
cardTokenoptionalstringCartão novo, tokenizado no app
customerDataoptionalobjectNome, e-mail, documento e telefone do pagador, como no checkout. Sem ele, usa o cliente do pedido original

Antworten

StatusBeschreibung
201Operação realizada com sucesso.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
402Requisição inválida — falha de validação.
404Recurso não encontrado.
409Conflito com o estado atual do recurso.
500Erro interno do servidor.

curl-Beispiel

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