Recorrência no cartão
Cobre o mesmo cartão todo mês ou todo ano, sem criar plano no painel, enviando o nó recurrence no POST /charges.
Modalidades
Abra o contrato com a primeira cobrança, feita na hora.
Consultar uma recorrênciaLeia o estado do contrato e as cobranças de cada ciclo.
Alterar o valorMude o valor dos próximos ciclos.
Desativar uma recorrênciaPare de gerar cobranças nos próximos ciclos.
Reativar uma recorrênciaVolte a cobrar um contrato desativado.
O recurrence.recurrentPaymentId da resposta da criação identifica o contrato nas consultas e nas alterações. Cada ciclo novo chega como evento recurrence.cycle na postbackUrl da cobrança que abriu o contrato, com o mesmo externalId dela. A mudança de status, a desativação, a reativação e a troca de valor do contrato não geram aviso.
Status do contrato
status | Significado |
|---|---|
ACTIVE | O contrato gera uma cobrança a cada ciclo. |
INACTIVE | A data em nextRecurrency não gera cobrança. |
ENDED | Contrato encerrado. |
Todos os valores da recorrência no cartão são inteiros em centavos.
10000 é R$ 100,00. creditCardPayment.installments é sempre 1, porque cada ciclo é cobrado à vista.
Esta recorrência não é a do PayZu Gateway.
Aqui não há plano, Pix nem chave de checkout, diferente da Recorrência do PayZu Gateway. As chamadas levam o token do PayZu Payments e, quando a credencial exige, o certificado mTLS, como em Token.