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

# Stripe

> Integre Pix, cartão, clientes e Checkout da Stripe

## Sobre a Stripe

A Stripe oferece infraestrutura global de pagamentos. No Brasil, a integração
do **pagamentos.dev** cobre clientes, Payment Intents, Checkout e webhooks para
Pix e cartão.

Consulte a [documentação oficial da Stripe](https://docs.stripe.com/).

## Métodos e recursos

* `pix` — Payment Intent em BRL
* `cartaoCredito` — Payment Intent com método tokenizado
* Clientes, cobranças, Checkout e webhooks assinados

## Credenciais e modo de teste

Use uma Secret Key `sk_test_...` durante o desenvolvimento. O endpoint de
webhook fornece um segredo `whsec_...` diferente para cada ambiente.

```ts pagamentos.ts theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Pagamentos, stripe } from 'pagamentos'

export const pg = new Pagamentos({
  providers: [
    stripe({
      secretKey: process.env.STRIPE_SECRET_KEY!,
      signingSecret: process.env.STRIPE_WEBHOOK_SECRET,
      mode: 'sandbox',
      successUrl: 'https://example.com/pagamento/concluido',
      cancelUrl: 'https://example.com/carrinho'
    })
  ]
})
```

<Note>
  O modo de teste não movimenta dinheiro. Use o Stripe CLI para encaminhar e
  disparar eventos localmente, mantendo a validação da assinatura ativa.
</Note>

Veja também [clientes](/features/clientes), [checkout](/features/checkout) e
[webhooks](/features/webhooks).