# Conecte sua conta do Paystack

> Receba por cartão, transferência bancária, USSD e dinheiro móvel na Nigéria, em Gana, na África do Sul, no Quênia e na Costa do Marfim com sua própria conta do Paystack. Em Configurações > Pagamentos, clique em Configurar Paystack, cole sua chave secreta, ative e clique em Salvar configurações.

Central de Ajuda / Pagamentos - Atualizado em 19 de novembro de 2026

O Paystack é a forma mais usada de pagar online na Nigéria, em Gana, na África do Sul, no Quênia e na Costa do Marfim. Quando você conecta sua conta do Paystack, seus clientes podem pagar com cartão, transferência bancária, USSD, dinheiro móvel ou com os outros métodos de pagamento que você ativou no Paystack. Os pagamentos vão direto para sua conta do Paystack, e o Shoprocket cobra 0 %.

Seus clientes pagam sem sair da sua loja. Quando clicam em **Pague agora**, a janela de pagamento do Paystack abre por cima do seu checkout. Eles pagam ali, a janela fecha e eles veem a confirmação do pedido. Os dados do cartão vão direto para o Paystack e nunca passam pelo Shoprocket.

## Antes de começar

Você precisa de uma conta empresarial do Paystack. Sua chave secreta fica no painel do Paystack, em **Settings > API Keys & Webhooks**. O Paystack dá duas chaves secretas a cada conta:

- a **chave secreta de teste**, que começa com `sk_test_`, para experimentar o checkout sem dinheiro de verdade
- a **chave secreta live**, que começa com `sk_live_`, para receber pagamentos reais depois que o Paystack ativar sua empresa

Copie a chave secreta, não a chave pública. A chave pública começa com `pk_` e o Shoprocket não precisa dela.

## Conectar o Paystack

1. No seu painel, vá em **Configurações > Pagamentos**.
2. No cartão do Paystack em **Gateways de pagamento**, clique em **Configurar Paystack**.
3. Cole sua chave secreta no campo **Secret Key**.
4. Coloque o botão do Paystack em **Ativado**.
5. Clique em **Salvar configurações**.

![O cartão do Paystack em Configurações > Pagamentos: Conectado, com uma chave de teste, a moeda que a conta aceita e a URL do webhook com o botão Copiar](https://shoprocket.io/img/help/connect-paystack/paystack-card.webp)

Quando você salva, o Shoprocket confere sua chave com o Paystack. Se o Paystack a recusar, nada é salvo e uma mensagem no topo da tela explica o motivo. O cartão passa a mostrar **Conectado**, e o Paystack aparece no seu checkout.

## Adicione sua URL de webhook no Paystack

Depois que o Paystack está conectado, o cartão dele mostra uma **Webhook URL**. O Paystack a usa para avisar o Shoprocket sobre pagamentos que terminam depois, como uma transferência bancária que o cliente conclui após fechar a janela de pagamento. Ele também a usa para avisar o Shoprocket sobre reembolsos que você faz no próprio Paystack.

1. Clique no botão de copiar ao lado da URL do webhook.
2. No painel do Paystack, vá em **Settings > API Keys & Webhooks**.
3. Cole a URL em **Webhook URL** e salve.
4. Mude o Paystack para o outro modo (teste ou live) e cole a mesma URL lá também.

Seus pedidos são confirmados mesmo sem a URL do webhook, porque o Shoprocket confere cada pagamento com o próprio Paystack. Adicioná-la faz um pagamento atrasado aparecer na hora no pedido.

## A moeda que sua conta aceita

Uma conta do Paystack recebe na moeda do país em que está registrada: naira na Nigéria, cedi em Gana, rand na África do Sul, xelim no Quênia e franco CFA na Costa do Marfim. Empresas na Nigéria e no Quênia também podem pedir ao Paystack que adicione dólares americanos.

Quando você salva sua chave, o Shoprocket pergunta ao Paystack quais moedas sua conta tem. Se ela tem só uma, o cartão a mostra, e o Paystack aparece no checkout apenas para clientes que pagam nessa moeda. Se os preços da sua loja estão em outra moeda, o cartão avisa, e você ainda pode oferecer o Paystack a clientes que pagam na moeda dele em **Gateway de cartão por moeda**, como explica [Escolha um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md).

## Teste com uma chave de teste

Cole sua chave secreta de teste para experimentar o checkout sem mover dinheiro de verdade. O cartão passa a mostrar **Chave de teste: nenhum dinheiro de verdade é movimentado**. A documentação para desenvolvedores do Paystack lista os cartões de teste que você pode usar.

Quando estiver pronto para vender, clique em **Editar as credenciais de Paystack**, cole sua chave secreta live e clique em **Salvar configurações**.

## Como os clientes pagam

- **Com cartão**: o cliente digita o cartão na janela do Paystack. Se o banco dele precisar conferir o pagamento com uma senha, um código de uso único ou uma verificação 3D Secure, isso acontece na mesma janela.
- **Com transferência bancária, USSD ou dinheiro móvel**: a janela do Paystack mostra a conta para pagar, o código a discar ou o aviso a aprovar no celular. O pedido é confirmado assim que o dinheiro chega.

Se um cliente fechar a janela do Paystack sem pagar, ele volta ao seu checkout com tudo o que digitou e pode tentar de novo.

Você não precisa fazer nada em nenhum desses casos. O Shoprocket marca o pedido como pago quando o Paystack confirma o pagamento e envia seus e-mails de pedido de sempre.

## Reembolsos

Quando você reembolsa um pedido pago com o Paystack, o dinheiro volta automaticamente ao cliente, total ou parcialmente. Veja [Reembolse um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md). O Paystack demora um pouco para processar um reembolso, então ele aparece como pendente no pedido até o Paystack confirmar. Um reembolso feito no painel do Paystack também aparece no pedido no Shoprocket, depois que sua URL de webhook for adicionada.

## Assinaturas

O Paystack pode renovar assinaturas. Quando um cliente compra uma assinatura com o cartão, o Paystack guarda o cartão, e o Shoprocket o cobra em cada data de renovação sem que o cliente precise voltar. Uma renovação paga por transferência bancária, USSD ou dinheiro móvel não pode ser cobrada de novo automaticamente, então clientes que compram uma assinatura devem pagar com cartão.

Se uma renovação for recusada, o Shoprocket tenta de novo nos dias seguintes e avisa o cliente, como faz com todos os gateways.

## Alterar a chave ou desativar

Depois que o Paystack está conectado, o botão dele passa a dizer **Editar as credenciais de Paystack**. Sua chave salva fica armazenada criptografada e nunca é mostrada de novo. O cartão mostra só os quatro últimos caracteres. Para mantê-la, deixe o campo em branco. Para substituí-la, cole a nova chave e clique em **Salvar configurações**.

Para deixar de oferecer o Paystack, coloque o botão dele em **Desativado** e clique em **Salvar configurações**. Sua chave continua salva, então você pode reativá-lo quando quiser.

## Artigos relacionados

- [Escolher um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md)
- [Reembolsar um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md)
- [Faça um pedido de teste](https://shoprocket.io/pt/ajuda/fazer-um-pedido-de-teste.md)

[Abrir Pagamentos no seu painel](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/pt/ajuda/conectar-paystack
- Language: Português (pt)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-paystack.md), [Deutsch](https://shoprocket.io/de/hilfe/paystack-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-paystack.md), [English](https://shoprocket.io/help/connect-paystack.md), [Español](https://shoprocket.io/es/ayuda/conectar-paystack.md), [Français](https://shoprocket.io/fr/aide/connecter-paystack.md), [עברית](https://shoprocket.io/he/help/connect-paystack.md), [हिन्दी](https://shoprocket.io/hi/help/connect-paystack.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-paystack.md), [Italiano](https://shoprocket.io/it/aiuto/collega-paystack.md), [日本語](https://shoprocket.io/ja/help/connect-paystack.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-paystack-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-paystack-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/paystack-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-paystack.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-paystack.md), [Русский](https://shoprocket.io/ru/help/connect-paystack.md), [ไทย](https://shoprocket.io/th/help/connect-paystack.md), [Türkçe](https://shoprocket.io/tr/yardim/paystack-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-paystack.md)
