> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ararahq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Configure o Brain para criar um link de pagamento Stripe na sua conta e enviar no WhatsApp, em BRL, USD ou EUR.

Ao final deste guia, o Brain cria um **Payment Link** na sua conta Stripe e envia a URL na conversa, pela Action `STRIPE_CHECKOUT`. Serve para pagamento com cartão e para clientes de fora do Brasil.

## Antes de começar

* Conta Stripe com chave de API.
* [Brain](/brain) configurado, com plano que inclui Brain e número dedicado.

Para Pix, use a Action [AbacatePay](/brain/actions/abacate-pix). O Brain é instruído a preferir Pix no Brasil quando as duas estão habilitadas.

## Quando o Brain usa

Quando o cliente quer pagar com cartão (não Pix) ou é internacional.

Parâmetros que o Brain preenche:

| Parâmetro | Obrigatório | Descrição |
| - | - | - |
| `amount_cents` | Sim | Valor em centavos |
| `description` | Sim | Descrição mostrada no checkout, até 100 caracteres |
| `currency` | Não | `BRL` (default), `USD` ou `EUR` |

## Passos

<Steps>
  <Step title="Crie uma chave de API no Stripe">
    Em **Developers → API keys**. A Action cria Product, Price e Payment Link a cada cobrança, então uma restricted key precisa de escrita em Products, Prices e Payment Links.
  </Step>

  <Step title="Habilite na Arara">
    ```bash theme={null}
    curl -X POST https://api.ararahq.com/v1/brain/actions \
      -H "Authorization: Bearer $ARARA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "actionType": "STRIPE_CHECKOUT",
        "enabled": true,
        "config": { "secretKey": "sua_chave_stripe" }
      }'
    ```

    A Action lê `secretKey` (ou `apiKey`, como alternativa). Nenhuma outra chave de config é usada.
  </Step>
</Steps>

## Fluxo

```
Cliente:   "Consigo pagar no cartão?"
  ↓
Brain:     [STRIPE_CHECKOUT amount_cents=19900 currency=BRL description="Plano mensal"]
  ↓
Stripe:    cria Product + Price + Payment Link na sua conta
  ↓
Brain:     "Aqui o link de pagamento (R$ 199,00):
            https://buy.stripe.com/...
            Aceita cartão. Pode parcelar dependendo do banco."
```

O Payment Link não expira sozinho: o cliente pode pagar depois.

## Limitações

* **Valor livre, sem catálogo de preços**: a Action cria um preço novo com o valor que o Brain definiu. Use as [regras do Brain](/brain) e a base de conhecimento pra limitar valores e descontos.
* **Pagamento único**: não cria assinatura nem altera assinatura existente.
* **Sem confirmação automática**: a Arara não recebe os webhooks da sua conta Stripe. Trate `checkout.session.completed` no seu sistema e responda a conversa se precisar confirmar no chat.
* **Um Product por cobrança**: cada link cria um Product e um Price novos na sua conta Stripe.

## Próximos passos

<CardGroup cols={2}>
  <Card title="AbacatePay (Pix)" icon="qrcode" href="/brain/actions/abacate-pix">
    Cobrança Pix, o meio mais comum no Brasil.
  </Card>

  <Card title="Voltar ao Brain" icon="brain" href="/brain">
    Configuração, Actions disponíveis e regras.
  </Card>
</CardGroup>


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