Conectando a Stripe

A IuzyPay orquestra o checkout, mas os pagamentos passam pelo seu gateway. Se a sua conta é na Stripe, conecte-a para cobrar por lá — inclusive junto com a Pagar.me e a Iugu, com a ordem de cobrança definida em Configurações → Gateways.

O que você vai precisar

No dashboard da Stripe, em Desenvolvedores → Chaves de API, copie:

• A chave secreta (sk_...) — usada para criar cobranças. Use a chave secreta padrão; chaves restritas (rk_...) não são aceitas.
• A chave publicável (pk_...) — obrigatória para tokenizar cartões com segurança no navegador.

As duas chaves precisam ser do mesmo ambiente: teste com teste (sk_test/pk_test) ou produção com produção. A IuzyPay valida isso na conexão.

Conectando

1. No painel, vá em Configurações → Gateways.
2. Clique em Conectar e escolha a Stripe.
3. Cole a chave secreta e a chave publicável. O ambiente (teste ou produção) é detectado automaticamente pelo prefixo da chave — sk_test_ é teste, o resto é produção.
4. Cadastre o webhook (abaixo) e salve — a IuzyPay valida as credenciais na hora.

Configurando o webhook

O webhook avisa a IuzyPay assim que um Pix é pago ou um cartão é aprovado, atualizando o pedido automaticamente. Ele é registrado uma vez no painel da Stripe:

1. No dashboard da Stripe, vá em Desenvolvedores → Webhooks e adicione um endpoint com a URL:

   https://api.iuzypay.com/v1/webhooks/stripe-gateway

2. Selecione os eventos:

   • payment_intent.succeeded
   • payment_intent.payment_failed
   • payment_intent.canceled
   • charge.refunded
   • charge.dispute.created
   • charge.dispute.closed

3. Salve.

Sem o webhook nada se perde — a IuzyPay reconsulta o gateway periodicamente e no botão Verificar do pedido —, mas a confirmação deixa de ser imediata.

Pix precisa estar habilitado na sua conta

O Pix é um método de pagamento que a sua conta Stripe precisa ter ativo: no dashboard da Stripe, em Configurações → Pagamentos → Métodos de pagamento, habilite o Pix. Sem isso, as cobranças Pix pela Stripe falham e o checkout só consegue cobrar cartão por ela.

Limites da Stripe hoje

• Cartão é sempre à vista. A Stripe não recebe pedidos parcelados: se a oferta permite parcelar e o comprador escolhe 2x ou mais, a cobrança vai para outro gateway da sua conta que aceite parcelas (como a Pagar.me). Se a Stripe for seu único gateway, configure as ofertas para 1x — veja parcelamento no cartão.
• Sem split de comissão. Comissões de afiliados e co-produtores em vendas processadas pela Stripe liquidam sempre como “A pagar” — você repassa por fora e registra a baixa.

Segurança

Suas chaves são criptografadas antes de serem salvas e nunca aparecem novamente em texto. O número do cartão do comprador é enviado direto para a Stripe pelo navegador (padrão PCI SAQ-A) — dados sensíveis de cartão nunca passam pelos servidores da IuzyPay.