Módulo de pagamento Oscommerce-PagSeguro 2.2 por Valmy Gomes

ATENÇÃO! PARA O CORRETO FUNCIONAMENTO DESTE MÓDULO, ESTEJA ATENTO ÀS CONFIGURAÇÕES QUE DEVEM SER FEITAS NO SITE PAGSEGURO E NO ADMIN DA LOJA, AMBAS SÃO FUNDAMENTAIS.

Este módulo contém pequenos ajustes feitos por Valmy Gomes no código Original de Claudio H. Imai:

*Agora todos os campos, inclusive DDD, complemento e número são preenchidos automaticamente, o que possibilita que o cliente caia direto na tela de pagamentos.

*O carrinho do pagseguro agora é esvaziado "normalmente" após a finalização da compra.

Notas sobre as correções:

No módulo anterior os campos de DDD, complemente e número não eram preenchidos, pois estes campos não existem na oscommerce, mas existentes no pagSeguro, o que obrigava o cliente a ter que completar manualmente as informações, provocando um passo a mais na finalização da compra e causando ceto incômodo, uma vez que o cliente já tem seu cadastro na loja, isto foi corrigido nesta versão.

O cliente, durante o checkout, será redirecionado diretamente para a tela de pagamentos do pagseguro somente se todas as informações de seu cadastro estiverem preenchidas e seu telefone informado não for celular ou Voip, pois o PagSeguro não aceita celular e Voip e neste caso pedirá o preenchimento correto, fazendo que o cliente cai na tela onde deverá completar ou corrigir seus dados.

Outro problema no módulo original era NÃO ESVAZIAR O CARRINHO DE COMPRAS após a finalização do pedido, quando o cliente retornava à loja o seu carrinho continuava cheio. isto eu resolvi com uma dica dada pelo usuário gugudelic encontrada no fórum http://www.omeunuke.com/modules.php?name=Forums&file=viewtopic&t=3456

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

INSTRUÇÕES DE INSTALAÇÃO E CONFIGURAÇÃO ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

ATENÇÃO! PARA O CORRETO FUNCIONAMENTO DESTE MÓDULO, ESTEJA ATENTO ÀSCONFIGURAÇÕES QUE DEVEM SER FEITAS NO SITE PAGSEGURO E NO ADMIN DA LOJA, AMBAS SÃO FUNDAMENTAIS.

Caso já tenha instalado o módulo do PagSeguro anteriormente no seu OsCommerce, desinstale o módulo antigo acessando a administração do site, clicando em "Remover" e em seguida siga os passos abaixo:

1)- Após fazer o download do arquivo, extraia os arquivos para as seguintes pastas:

* includes\languages\portugues\modules\payment\pagseguro.php

* includes\modules\payment\pagseguro.php * ext\modules\payment\pagseguro.php

2-) Assim que extrair os arquivos, você deverá entrar na administração do seu site e instalar o módulo PagSeguro.

*Na administração, Clique em "modulos", depois clique em "pagamento", na tela que abrir, clique em "PagSeguro - pagamentos" e em seguida, no lado direito, cliquem em "install".

3-)Agora, ainda no lado direito do módulo Pagseguro, clique em "editar" e faças as configurações:

*Voce deseja aprovar compras utilizando o PagSeguro?

(Marque "true", se marcar "false" o módulo será desativado)

*Email no PagSeguro - Informar o email de cobrança registrado junto ao PagSeguro

(Coloque aqui o e-mail com o qual você se cadastrou no Pagseguro)

*Token - Código de segurança gerado manualmente no website do PagSeguro.

(Para gerar o seu TOKEN acesse no site do Pagseguro o menu "Meus Dados >> Retorno Automático")

*Moeda padrão - Código da moeda usado em seu site para o Real. Por ex.: BR, BRL, etc.

(Coloque aqui o código de moeda usado na sua loja. Atenção, para o Real geralmente é BR e am alguns casos BRL, verifique isto na sua loja. Para saber qual é seu código de moeda, no admin da loja, clique em "Localização> Moedas" e veja o código.)

*Unidade de peso - Você deseja calcular o frete em KG ou gramas?

(Marque a opção que você usa na sua loja. Coloque Kg se você preenche os pessoas assim: 0.5 ou gramas se preencehe assim: 300) Isto só afeta o cálculo de frete direto do pagSeguro, não o de módulos próprios.)

*Cálculo do frete pelo PagSeguro? - Você deseja calcular o frete através do site do PagSeguro?

(ATENÇÃO IMPORTANTE: Se você usa módulo de frete como PAC, sedex, etc, marque false e então você deverá acessar o site do Pagseguro, ir no menu "Meus Dados >> Preferências Web e Frete" e selecionar a opção número 2.)

(Só marque "true" se você quer que o cálculo de frete seja feito pelo pagseguro.Então você deverá acessar (no site do pagseguro) o menu "Meus Dados >> Preferências Web e Frete" e selecionar a opção número 3.)

NOTA: NÃO SEI O MOTIVO, MAS OBSERVEI DIFERENÇAS ENTRE O VALOR DO FRETE CALCULADO PELO PAGSEGURO E PELO SITE DOS CORREIOS, FIQUEM ATENTOS, eu sugiro que usem módulos de cálculo de frete separados)

*Aceita cartão? - Sua conta está configurada para aceitar cartões de crédito?

(Marque "true" se você quer receber pagamentos por cartões de crédito. NOTA: PAGAMENTOS POR CARTÃO DE CRÉDITO SÃO SOMENTE PARA CONTAS VENDEDDOR OU EMPRESARIAL. Acesse o site do PagSeguro e transforme sua conta em uma conta VENDEDOR ou EMPRESARIAL)

*Zonas suportadas- Se uma zona for selecionada, este meio de pagamento estará disponível somente para esta zona.

(Deixe como está ou marque a Zona suportada caso sua loja esteja configurada desta maneira).

*Status dos pedidos - Atualiza o status dos pedidos efetuados por este módulo de pagamento para este valor.

(Configure qual o estatus do Pedido assim que ele é feito)

*Pedidos aprovados - Atualiza o status dos pedidos aprovados por este módulo de pagamento para este valor.

(configure para qual estatus o pedido será atualizado assim que o pagamento for aprovado)

*Debug log - O módulo deve criar um log de debug na pasta EXT?

(deixe "false". Só marque "true" se quiser que o pagseguro gere um LOG para acompnahmento manual, neste caso, dê permissão de escrita à pasta EXT. o arquivo debug.log conterá informações sobre a comunicação entre os servidores.)

*Email de debug - Todos os parâmetros de uma notificação inválida serão enviados para este endereço de email se estiver presente.

(Pode deixar em branco. Ou então colque um e-mail onde receberá informações de debug sobre tentativas de transações inválidas ou fraudulentas.)

*Ordem de exibição - Determina a ordem de exibição do meio de pagamento.

(O número que você colocar será o ordem que este módulo será exibido em relação aos demais módulos de pagamemto da loja)

4-) IMPORTANTE! Acesse o site do Pagseguro e vá "MEUS DADOS > Retorno automático" e coloque a URL de retorno que é

ext/modules/payment/pagseguro.php

Mas coloque o seu endereço completo:

http://www.SEUSITE.COM.BR/ext/modules/payment/pagseguro.php

Pronto. O módulo PagSeguro foi instalado com sucesso e agora você poderá receber todas as formas de pagamento que o PagSeguro oferece.

Sugiro que dê uma navegada pelo site do PagSeguro e leia atentamente todas as instruções para um melhor entendimento de como funciona.

Abraços a todos!

Até aqui nos ajudou o Senhor

Valmy Gomes