Saltar al contenido

Paga agora uma assinatura em atraso

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

Auth
Requiere token
Quién puede:
owner
admin
SuperAdmin
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.

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

Parámetros

NombreDóndeTipoDescripción
idobligatoriopathstring (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
paymentMethodobligatorioCREDIT_CARD | DEBIT_CARD | PIX | BOLETO
installmentsopcionalintegerSó no cartão, até o maxInstallments do produto · ≥ 1, ≤ 12
paymentMethodIdopcionalstring (uuid)Cartão salvo do assinante (/payment-methods)
cardTokenopcionalstringCartão novo, tokenizado no app
customerDataopcionalobjectNome, e-mail, documento e telefone do pagador, como no checkout. Sem ele, usa o cliente do pedido original

Respuestas

CódigoDescripción
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.

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