GET
/credit-cards/{creditCard}/recurringsRecorrências do Cartão
Lista assinaturas e cobranças recorrentes detectadas nas transações do cartão (sem parcelas).
Observações
- Derivado localmente após o sync de transações — não é um recurso Open Finance da instituição.
- Detecção determinística: agrupa por merchant normalizado (remove gateways tipo "Ifd*"), clusteriza valores por moeda (assinaturas internacionais usam o valor original, imune ao câmbio) e valida cadência mensal com no mínimo 3 meses cobrados.
- Exclui parcelamentos (charge_number > 1 ou payment_type A_PRAZO), tarifas/IOF, estornos e créditos.
- MCCs de consumo avulso (mercado, posto, estacionamento) exigem valor idêntico e cadência perfeita para evitar falsos positivos.
Query Parameters
| Field | Type | Description |
|---|---|---|
| cursor | string | Cursor de paginação (cursor-based). Use o next_cursor da resposta anterior para avançar. 50 itens por página. |
Response Fields
| Field | Type | Description |
|---|---|---|
| description | string | Nome normalizado da recorrência (ex.: netflix). |
| averageAmount | number | Valor médio em BRL das ocorrências. Débito é negativo. |
| currency | string | Moeda original da cobrança (ISO 4217). Assinaturas internacionais mantêm a moeda de origem (ex.: USD) mesmo com averageAmount em BRL. |
| periodMonths | integer | null | Período detectado em meses (1 = mensal, 2, 3, 6 ou 12). |
| expectedDay | integer | null | Dia do mês esperado para a cobrança (mediana das ocorrências). |
| firstOccurrenceAt | string | null | Data (Y-m-d) da primeira ocorrência conhecida. |
| lastOccurrenceAt | string | null | Data (Y-m-d) da última ocorrência conhecida. |
| nextExpectedAt | string | null | Data (Y-m-d) prevista para a próxima cobrança (última + periodMonths). |
| occurrences | string[] | IDs das transações do cartão que formam a recorrência. |
| regularityScore | number | Score de regularidade entre 0 e 1 (confiança da detecção). |