> For the complete documentation index, see [llms.txt](https://docs.getcommerce.com.br/central-de-ajuda/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getcommerce.com.br/central-de-ajuda/integracoes/meios-de-pagamento/cartao-de-credito-pagseguro.md).

# Cartão de Crédito (PagSeguro)

## **📍** O que preciso para integrar?

O primeiro passo é você ter uma conta ativa no PagSeguro. Se ainda não possui, [clique aqui](https://cadastro.pagseguro.uol.com.br/?origin=GetCommerce) para criar.&#x20;

E depois, para integrar o PagSeguro na sua loja virtual Get Commerce você basicamente precisa apenas de 2 informações:

* E-mail de login no PagSeguro
* Token de produção

\*Para gerar o token do Pagseguro (nas novas contas agora PagBank), acesse sua conta no PagSeguro e clique no menu **VENDAS >> INTEGRAÇÃO.**

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FUF4Nd3f44b5nQKhnpOV4%2F169494-1693933532652.png?alt=media&amp;token=b8347897-f13d-4247-82ca-5681d7e6ccaa" alt=""><figcaption></figcaption></figure>

A única informação que vamos utilizar será o Token. Gere ele, copie e guarde.&#x20;

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2F50uamJNzS31D5vcacNND%2F43749-1567537904464.png?alt=media&amp;token=5255ba55-bab2-40f1-b70e-c09c7e109a59" alt=""><figcaption></figcaption></figure>

A integração com o PagSeguro possui a opção de <mark style="color:blue;">**cartão de crédito**</mark> integrada.

## **📍** Como instalar o módulo do PagSeguro?

Acesse o menu Configurações, Central de Instalações e Integrações.&#x20;

![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FL52v4c3LvTiJOaEHF1nB%2FCaptura%20de%20Tela%202023-07-19%20a%CC%80s%2009.51.26.png?alt=media\&token=e7c94816-f3b9-48d4-9089-2634e1eb9713)

Identifique a aba "Meios de Pagamento", clique em solicitar, preencha os dados (Email de login do PagSeguro + Token) e por último confirme seu pedido. Será realizada uma validação automática nos dados e quando concluída, você receberá um e-mail de sucesso!

## **📍**Como configurar o módulo do PagSeguro?

Seu módulo já estará ativo e pronto para vender, após você instalar.

Porém, pode ocorrer a necessidade de atualizar seu token PagSeguro. Ou você pode desejar, mudar sua conta PagSeguro.

Nestes casos, é super simples!

Basta acessar o menu Configurações, Configurações da Loja, e identificar a aba "Formas de Pagamento".

Nela você encontrará a seção PagSeguro.&#x20;

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FTekReo25edkYpiXNyyPm%2Fimage.png?alt=media&amp;token=e03984f0-47f2-4fa5-b774-5ebc1f720d4e" alt=""><figcaption></figcaption></figure>

Nesta aba você poderá trocar seu e-mail e token.

E também pode Habilitar ou Desabilitar o módulo de pagamento, como também trocar o título que aparece para o cliente no UltraCheckout e a Ordenação (ordem que irá aparecer nas opções de pagamento).

{% hint style="info" %}
Importante.

No PagSeguro, a configuração de parcelamento sem juros e outras condições especiais é realizado diretamente na plataforma do PagSeguro. Ao realizar as mudanças no painel deles, já irá refletir na loja virtual.
{% endhint %}

## 🤔 Dúvidas Comuns.

<details>

<summary>Mensagem "Houve uma falha ao processar seu pedido/pagamento..." ao finalizar pedido.</summary>

Esse erro ocorre em geral, por alguma instabilidade no webservice do Paseguro. Em resumo, a loja envia o pedido para ele processar, porém devido à alguma instabilidade ele gera um retorno inesperado.

Verifique se o momento que isto aconteceu, o serviço de /sessions do PagSeguro estava fora do ar (com oscilações). Você pode consultar [este monitor](https://pagseguro.ricardomartins.net.br/status.html).

O que ainda você pode verificar, se exibir para todos os pedidos:

* Token/email não autorizado pelo PagSeguro. Verifique suas configurações no painel.
* Acesso não autorizado à Api Pagseguro. Verifique se você tem permissão para usar este serviço.

</details>

<details>

<summary>Como configurar parcelamento sem juros com o PagSeguro na loja virtual?</summary>

Para criar um parcelamento sem acréscimo em suas vendas feitas pela loja virtual, você deve configurar que este parcelamento direto na sua conta do PagSeguro.&#x20;

Siga o passo a passo:

1. Acesse sua Conta PagSeguro
2. No menu clique em Parcelamento e depois Criar Promoção
3. Preencha os campos solicitados de acordo com a sua preferência
4. E para concluir pressione o botão Salvar

Pronto! Promoção criada.

Esta tela irá informar as suas condições específicas.

![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FQ6oeTcJSUmmGoAo1rYsy%2FCaptura%20de%20Tela%202023-07-10%20a%CC%80s%2016.22.07.png?alt=media\&token=688aed06-59e3-471b-8cb0-8e9b6294ab33)

E para criar uma promoção, a tela terá essas opções abaixo:

![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FHMwNr1yb0XtVn6eHjIm9%2Fcompras.png?alt=media\&token=18ef6123-71f4-42af-a6c9-fb90a1cffee6)

</details>

<details>

<summary>Todos os pagamentos que faço mesmo com meu cartão são negados. Porque?</summary>

O PagSeguro nega qualquer pedido feito pelo próprio dono da loja. Se o cartão for do mesmo titular do dono, ou se o acesso partir da mesma máquina que um dia logou na administração do pagseguro, eles tendem a recusar e negar a transação.

</details>

<details>

<summary>O token PagSeguro digitado não é válido.</summary>

Fique atento ao aviso de Token inválido no painel da sua loja virtual.

E caso esteja marcando Token inválido, o processo é simples! Basta gerar um novo token no seu painel do PagSeguro e salvar na loja virtual da Get, seguindo os procedimentos gerais acima!

![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2F8P7ee3pgOzz8h9Zg7J0h%2FCaptura%20de%20Tela%202023-07-19%20a%CC%80s%2010.09.03.png?alt=media\&token=6fa30388-d20f-49a8-9bea-86f5c06bdcec)

</details>

<details>

<summary>Muitos pedidos estão sendo negados no PagSeguro</summary>

O PagSeguro possui um complexo sistema anti fraude. Sistemas como esse visam evitar que pessoas mal intencionadas usem cartões clonados ou realizem compras com cartões de outras pessoas.

Se a sua loja está tendo um alto número de pedidos negados, isso pode se dar por diferentes razões. Entre elas:

* **Endereço de cobrança** - O endereço de cobrança deve corresponder ao endereço da fatura do cartão. Quando o mesmo é diferente, o nível de suspeita de fraude aumenta pois o sistema de fraude pode entender que é outra pessoa que está realizando a compra.
* **Dados diferentes do titular do cartão** - Nome, CPF, Endereço de destino é diferente do titular do cartão, isso pode acarretar na prevenção de fraude.
* **Tipo de produto vendido** - Alguns produtos estão mais sujeitos à tentativa de fraude, enquanto outros não. Desta forma, produtos como eletrônicos, auto peças, créditos de celular, estão mais sujeitos a um antifraude rigoroso do que uma loja de livros universitários. Afinal, bandido não gosta muito de estudar, não é mesmo? :)
* **Compra inconsistente com o perfil do comprador** - Empresas de cartões estão sempre analisando o perfil de compra de seus clientes. E este é um dos fatores de risco de uma transação. Isto é, quando um cliente tenta comprar algo que não condiz com seu perfil de compra.
* **Valor da compra** - Valor não condiz com o perfil de despesas do comprador de forma geral ou naquela categoria.

### Quem negou o pedido? <a href="#origem-cancelamento" id="origem-cancelamento"></a>

Um pedido pode ser negado pelo próprio **PagSeguro** (antes mesmo de ser enviado à operadora/banco) ou pela **Instituição Bancária**.

Quando uma transação é negada, o módulo adiciona aos **comentários do pedido** quem foi o **responsável por negar a transação**.

Tanto os **Pedidos negados pelo PagSeguro**  quanto os **Pedidos negados pelo Banco** geralmente estão ligados a dados inválidos de cartão, limites ou ao antifraude. No caso do antifraude, geralmente ligado a um dos itens acima

### O que fazer? <a href="#oque-fazer" id="oque-fazer"></a>

**Negado pelo banco:** oriente o cliente a entrar em contato com o banco para avaliar seus limites ou o motivo da negação da transação. Na maioria dos casos o problema está ligado ao limite do cartão. Em outros casos está relacionado ao tipo de despesa e requer uma habilitação manual por parte do banco. Nesses casos, o banco fará o desbloqueio e orientará o cliente a repetir a compra.

**Negado pelo próprio PagSeguro:** nestes casos você (lojista) deve entrar em contato com o PagSeguro informando o código da transação e solicitando mais informações sobre a razão da negação de compra. Sugiro que faça isso apenas quando o número de pedidos negados for realmente grande. Na maioria dos casos a compra teria sido negada pelo antifraude independente do meio de pagamento (Paypal, PagSeguro, etc) e raramente tem a ver com problemas relacionados à sua loja. **Manter seus módulos atualizados e utilizar o modelo de aplicação também melhoram significativamente este tipo de reprovação.**

### Como evitar ou reduzir? <a href="#evitar" id="evitar"></a>

Meios de pagamento também levam em consideração a quantidade de ***chargebacks*** que ocorrem em sua conta.

Chargebacks são causados geralmente quando um cliente não reconhece a compra em sua fatura ou porque não recebeu o produto ou serviço comprado.

Para evitar esse tipo de problema, configure sua conta empresarial no PagSeguro com um nome que realmente **identifique sua loja na fatura de seus clientes** e os façam lembrar que realizaram aquela compra.

Isso pode ser feito acessando sua conta PagSeguro em [Configurações > Meus Dados](https://pagseguro.uol.com.br/data/edit.jhtml).

<img src="https://pagsegurotransparente.zendesk.com/hc/article_attachments/360027289211/PagSeguro_UOL_-_Dados_cadastrais.jpg" alt="PagSeguro_UOL_-_Dados_cadastrais.jpg" data-size="original">

</details>
