Renova uma assinatura (agenda o próximo ciclo)
/v1/subscriptions/{subscriptionId}/cyclesAutentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.
Parâmetros do caminho
subscriptionIdstringobrigatórioIdentificador público (subs_/sub_…)
Respostas
201Criado
idstringobrigatórioIdentificador público (scy_/cycle_…)
cycleintegerobrigatórioNúmero do ciclo (1 = o primeiro).
_linksobjectLinks para operações relacionadas, por ação (
self,create,update,delete,list…).amountintegerobrigatóriopode ser nuloValor da última cobrança ligada ao ciclo, em centavos;
nullquando não há.methodstringobrigatóriopode ser nuloMeio de pagamento dessa cobrança;
nullquando não há.statusstringobrigatórioStatus do ciclo:
scheduled,processing,paid,failedoucanceled.dueDatestringobrigatórioQuando o ciclo é cobrado (ou vence).
endDatestringobrigatóriopode ser nuloQuando o ciclo termina;
nullenquanto aberto.failureobjectobrigatóriopode ser nuloPor que o ciclo falhou;
nullquando não falhou, ou quando o motivo não foi registrado.+4 campos de
failureatstringobrigatóriopode ser nuloQuando falhou.
codestringobrigatóriopode ser nuloCódigo estável da falha (
noCard,noBillingAddress,unpriceableItems, ou o código de recusa da cobrança).stagestringobrigatóriobeforeCharge: a cobrança nunca foi tentada (sem cartão, boleto sem endereço, item sem preço);charge: o pagamento foi recusado.Valores:beforeChargechargemessagestringobrigatóriopode ser nuloA mensagem da recusa, quando a cobrança foi tentada.
attemptsintegerobrigatórioTentativas de cobrança até agora (o limite de retentativas é 5).
billedAtstringobrigatóriopode ser nuloQuando o ciclo foi cobrado;
nullaté lá.merchantobjectA conta dona do recurso (o vendedor de registro).
+3 campos de
merchantnamestringobrigatóriopode ser nuloNome fantasia da conta dona do recurso.
merchantIdstringobrigatóriopode ser nuloId público da conta dona do recurso (
bus_…).isSubAccountbooleanobrigatóriotruequando o recurso pertence a uma sub-conta operada por uma plataforma de marketplace.
createdAtstringobrigatórioQuando o recurso foi criado (ISO 8601, UTC).
startDatestringobrigatórioQuando o ciclo começa.
updatedAtstringobrigatórioQuando o recurso foi atualizado pela última vez (ISO 8601, UTC).
nextAttemptAtstringobrigatóriopode ser nuloQuando um ciclo falho é tentado de novo;
nullquando não será.transactionIdstringobrigatóriopode ser nuloA última cobrança ligada ao ciclo;
nullquando não há.expectedAmountintegerobrigatóriopode ser nuloNo ciclo em aberto: o que ele cobraria agora, em centavos;
nullnos outros, ou quando ainda não dá para saber.
401Não autenticado (credencial ausente ou inválida)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
403Sem permissão
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
404Não encontrado
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
422Regra de negócio impede o processamento
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
500Erro interno do servidor
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório