# Aceite pagamentos de meses sin intereses

Saiba como aceitar pagamentos com cartão de crédito usando meses sin intereses em vários produtos da Stripe.

As parcelas (meses sin intereses) são um recurso dos cartões de crédito para consumidores no México que permite aos clientes dividir compras em várias faturas. Você recebe o pagamento como se fosse uma cobrança avulsa normal, com as tarifas deduzidas, e o banco do cliente gerencia a cobrança dos valores ao longo do tempo.

Algumas restrições se aplicam a quais transações e cartões podem usar parcelas. Revise os [requisitos de compatibilidade](https://docs.stripe.com/payments/mx-installments.md#requirements).

A aceitação de um pagamento parcelado incorre em uma [tarifa adicional](https://docs.stripe.com/payments/mx-installments.md#fees) à tarifa padrão de transação com cartão de crédito.

Você pode habilitar as parcelas em vários produtos da Stripe. Escolha abaixo as instruções correspondentes à sua implementação.

# Faturas


## Integre com o Invoicing

Você pode aceitar parcelas com o [Invoicing](https://docs.stripe.com/invoicing.md).

As faturas oferecem uma lista de itens de mercadorias e serviços, que incluem preço, quantidade e impostos. Você também pode usá-los como uma ferramenta de coleta de pagamento.

Seus clientes podem pagar com o Checkout usando cartões (com ou sem parcelas) e outras formas de pagamento que aceitam o Checkout.

## Habilitar parcelamento para o Invoicing

Você pode criar uma fatura que aceita um pagamento parcelado usando a API Invoicing ou o Stripe Dashboard.

Se quiser mais personalização, recomendamos usar a API Invoicing. Se quiser configurar o Invoicing sem escrever código, use o Stripe Dashboard.

> Você pode habilitar parcelas para faturas individuais, mas não para assinaturas.

## Use a API Invoicing para configurar uma fatura que pode ser paga em parcelas

O Stripe Invoicing permite receber pagamentos parcelados. Você pode usar este [guia de integração](https://docs.stripe.com/invoicing/integration.md) para configurar faturas.

1. [Revisar documentação do Invoicing](https://docs.stripe.com/payments/meses-sin-intereses/accept-a-payment.md#review-invoicing-documentation)
2. [Criar uma fatura](https://docs.stripe.com/payments/meses-sin-intereses/accept-a-payment.md#create-new-invoice)
3. [Selecionar um plano de parcelamento no cliente](https://docs.stripe.com/payments/meses-sin-intereses/accept-a-payment.md#select-plan)
4. [Recuperar o plano de parcelamento selecionado](https://docs.stripe.com/payments/meses-sin-intereses/accept-a-payment.md#retrieve-plan)

## Revisar a documentação do Invoicing

Consulte o [guia de integração da API Invoicing](https://docs.stripe.com/invoicing/integration.md) e a documentação da API Invoicing para se familiarizar com a criação e o envio de uma fatura genérica.

## Criar uma fatura

Crie uma nova fatura com uma chave de API válida, um cliente representado por um objeto [Account](https://docs.stripe.com/api/v2/core/accounts/object.md) configurado como cliente ou um objeto [Customer](https://docs.stripe.com/api/customers/object.md), e um objeto [Price](https://docs.stripe.com/api/prices.md), conforme mostrado no exemplo abaixo.

> #### Use a API Accounts v2 para representar clientes
> 
> A API Accounts v2 está geralmente disponível para usuários do Connect e em prévia pública para outros usuários da Stripe. Se faz parte da prévia de Accounts v2, é necessário [especificar uma versão de prévia](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) no seu código.
> 
> Para participar da prévia de Accounts v2, acesse [Prévias e recursos da conta](https://dashboard.stripe.com/settings/previews) no Dashboard e ative **Formas de pagamento reutilizáveis para Global Payouts**.
> 
> Para a maioria dos casos de uso, recomendamos [modelar seus clientes como objetos Accounts configuradas pelo cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), em vez de usar objetos [Customer](https://docs.stripe.com/api/customers.md).

#### Accounts v2

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d "pricing[price]={{PRICE_ID}}"
```

As parcelas funcionam apenas com `collection_method` definido como o modo `send_invoice`. O modo `charge_automatically` não permite parcelas.

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d "payment_settings[payment_method_options][card][installments][enabled]=true"
```

#### Customers v1

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer={{CUSTOMER_ID}}" \
  -d "pricing[price]={{PRICE_ID}}"
```

As parcelas funcionam apenas com `collection_method` definido como o modo `send_invoice`. O modo `charge_automatically` não permite parcelas.

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer={{CUSTOMER_ID}}" \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d "payment_settings[payment_method_options][card][installments][enabled]=true"
```

## Selecionar um plano de parcelamento no cliente

A página de fatura hospedada exibe as opções de parcelamento disponíveis de acordo com o número do cartão de crédito informado pelo cliente.

Se um cliente clicar em **Pagar em parcelas**, a opção de plano de parcelamento selecionada por padrão é o primeiro plano da lista.

O cliente pode selecionar a opção de parcelamento desejada na interface de fatura hospedada.

Os planos parcelados só aparecem para cartões de crédito que os aceitam e para transações com valor total superior ou igual a MXN 300,00.

Em uma *área restrita* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), você pode usar [números de cartão de teste](https://docs.stripe.com/payments/meses-sin-intereses/accept-a-payment.md#testing) para testar diferentes comportamentos.

## Recuperar o plano de parcelamento selecionado

O plano de parcelamento selecionado está disponível no Dashboard e na API. No Dashboard, clique em um pagamento e role até **Dados de pagamento**. Se usou parcelas, você verá a duração do plano.

O plano de parcelamento selecionado também está disponível no PaymentIntent. Após o usuário concluir o pagamento, obtenha o ID do PaymentIntent do objeto Fatura (por exemplo, “payment_intent”: “pi_…”) e use-o para recuperar o objeto PaymentIntent e ver qual plano de parcelamento o cliente selecionou.

```curl
curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

Com o ID da intenção de pagamento, recupere o objeto PaymentIntent:

```curl
curl https://api.stripe.com/v1/payment_intents/{{PAYMENTINTENT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

O objeto PaymentIntent mostra o plano de parcelamento selecionado:

```json
{
  "id": "pi_...",
  "object": "payment_intent",
  "amount": 100000,
...
  "charges": {
    "data": [
      {
        "id": "ch_...",
        "object": "charge",
        "amount": 100000,
        "payment_method_details": {
          "card": {
            "installments": {
              "plan": {
                "count": 3,
                "interval": "month",
                "type": "fixed_count"
              }
            },
          },
          ...
        },
        ...
      }
    ],
  },
...
  "payment_method_options": {
    "card": {
      "installments": {
        "enabled": true,
        "plan": {
          "count": 3,
          "interval": "month",
          "type": "fixed_count"
        },
        "available_plans": []
      }
    }
  }
}
```

## Use o Stripe Dashboard para enviar uma fatura que pode ser paga em parcelas

Para configurar o parcelamento no Invoicing, acesse a página de configurações de formas de pagamento do [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods).

Você pode configurar os planos mensais específicos que deseja oferecer e os valores de transação mínimos e máximos para cada plano.

Essa configuração de forma de pagamento está habilitada para o Invoicing e todas as suas outras integrações compatíveis da Stripe, incluindo API, Checkout, Payment Element e Payment Links.

Você pode criar uma fatura com apenas alguns cliques usando o [Stripe Dashboard](https://dashboard.stripe.com/customers).

1. Na página [Clientes](https://dashboard.stripe.com/customers), clique em **Adicionar cliente** para criar um cliente (selecione o país como **México**, o idioma como **Espanhol (América Latina)** e a moeda como **MXN - Peso mexicano**)

1. Clique no cliente recém-criado para ver as informações, incluindo as faturas.

2. Na página de visão geral do cliente, clique em **Ações** e selecione **Criar fatura** para configurar uma nova fatura para esse cliente.

3. Na página “Criar fatura”, confira a seção **Pagamento** para verificar se os cartões estão ativados e se a opção **Permitir pagamento parcelado no cartão (meses sin intereses)** também está ativada.

4. Clique em **Encontrar ou adicionar um item** na seção **Itens** para adicionar produtos à fatura.

5. Clique em **Revisar fatura** no canto superior direito da página “Criar fatura” para finalizar a fatura e agendar o envio ao cliente

6. Você pode ver o status das faturas dos clientes na seção **Faturas** da página de visão geral do cliente.

Seu cliente recebe a fatura por e-mail. A fatura contém as instruções de envio do pagamento para cobrir a compra.

A fatura está disponível em três formatos: diretamente no corpo do e-mail, como um PDF anexado ao e-mail e como uma página de fatura hospedada.

Você pode ver o status de uma fatura específica a qualquer momento na página de visão geral do cliente.


## Configurações personalizadas

Você pode personalizar a configuração das parcelas usando a página de configurações de formas de pagamento do [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods).

Você pode encontrar a opção para ativar ou desativar o parcelamento na [página de configurações de formas de pagamento](https://dashboard.stripe.com/settings/payment_methods). Essa configuração permite habilitar parcelas para formas de pagamento sem programação, incluindo Payment Links e Checkout.

Separadamente, na página de configurações de formas de pagamento, você também pode configurar os planos mensais específicos que deseja oferecer e os valores de transação mínimos e máximos para cada plano. Essas configurações de plano se aplicam a todas as suas integrações de parcelas existentes.

## Testar a integração

Você pode usar os cartões abaixo para testar a integração:

| Número | Descrição |
| --- | --- |
| 4000004840000008 | Planos de parcelamento disponíveis: 3, 6, 9, 12, 18 e 24 meses |
| 4242424242424242 | Nenhum plano de parcelamento disponível. |