> ## Documentation Index
> Fetch the complete documentation index at: https://malga-develop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Recorrência do provedor

> Repasse informações de recorrência ao provedor através do parâmetro recurrence em cobranças de cartão de crédito na API Charges da Malga.

export const CheckIcon = ({mode, type, id}) => {
  const colorIcons = {
    'error': '#919191',
    'success': '#00AE42',
    'noSupported': '#919191'
  };
  const foundColor = colorIcons[mode];
  const iconType = mode === 'noSupported' ? type : `circle-${type}`;
  return <div className="check-icon" id={id}>
      <Icon icon={iconType} iconType="regular" color={foundColor} size={18} />
    </div>;
};

Ao realizar uma nova cobrança no método de crédito, é possível enviar o parâmetro `recurrence`, indicando se a cobrança faz parte de uma cobrança recorrente. Confira a estrutura de requisição para criar uma cobrança com a [API Charges](/api-reference/charges/realizar-nova-cobranca).

<Info>
  Usando essa propriedade, é possível informar aos provedores que uma transação faz parte de uma recorrência, e portanto não há presença do CVV do cartão nas cobranças subsequentes ou avulsas, aumentando as taxas de aprovação dessas transações.
</Info>

A propriedade pode assumir os valores `initial`, `subsequent` ou `unscheduled`, de acordo com os cenários indicados abaixo:

| Recurrence | Descrição |
| - | - |
| `initial` | indica a primeira transação de uma recorrência |
| `subsequent` | indica transação que é parte de uma recorrência com frequência determinada |
| `unscheduled` | indica transação não programada ou sem parcelas fixas dentro de uma periodicidade determinada, parte de uma recorrência |

### Provedores com suporte ao parâmetro de recorrência

| Provedor | Suporte |
| - | :-: |
| Adyen | <CheckIcon type="check" mode="success" /> |
| Barte | <CheckIcon type="check" mode="success" /> |
| Braspag | <CheckIcon type="check" mode="success" /> |
| Cielo | <CheckIcon type="check" mode="success" /> |
| Getnet SEP | <CheckIcon type="check" mode="success" /> |
| Pagarme v5 | <CheckIcon type="check" mode="success" /> |
| Pagseguro | <CheckIcon type="check" mode="success" /> |
| PicPay | <CheckIcon type="check" mode="success" /> |
| Rede | <CheckIcon type="check" mode="success" /> |
| Safrapay | <CheckIcon type="check" mode="success" /> |
| Worldpay | <CheckIcon type="check" mode="success" /> |

<Tip>
  No menu [Cobranças](https://dashboard.malga.io/) do Dashboard Malga, é possível extrair o relatório completo de cobranças, em formato `.csv`, contendo todas as informações das cobranças recorrentes. Confira [aqui](/documentations/dashboard/export-data) o passo a passo para obtenção do relatório e os dados disponíveis.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.