Central de Ajuda

Cartão de Crédito | PagSeguro v4.0

O Pagseguro é um adquirente de meios de pagamentos parceira do Pagar.me que processa pagamentos de cartão de crédito das bandeiras Visa, MasterCard, Hipercard, Hiper, Elo e Amex.

Como contratar

Para contratar o PagSeguro como adquirente da sua loja é necessário contatar a equipe comercial do PagSeguro entrará em contato.

Como homologar

Após ter a sua conta criada junto ao PagSeguro, solicite a liberação das chaves na API este formulário. Com as chaves liberadas, será necessário enviar ao Pagar.me o TOKEN de acesso

Veja aqui como gerar o seu token.

Em caso de dúvidas sobre como gerar o seu token, basta acionar o time de integrações PagSeguro através deste formulário

Autorização e Captura: 

  • O Pagseguro permite autorização com captura automática ou captura posterior (delay capture) do valor total da operação. Ainda não há a possibilidade de realizar a captura parcial do pedido, somente a captura total
  • O prazo máximo para realizar a captura posterior de uma autorização é de 6 dias corridos após a data da autorização.
  • Caso a captura não seja feita neste prazo, a autorização expira e não será mais possível capturar e nem enviar uma chamada de cancelamento para essa transação.
    A transação ficará visível apenas no seu dashboard, com o status "Autorizada pendente de captura", não sendo possível a visualização no painel do PagSeguro. 

Cancelamento e Estorno:

É possível realizar um cancelamento, estorno ou estorno parcial via API ou no dashboard:

Existe uma pequena diferença entre essas três funções:

  • Cancelamento
    Pedidos desfeitos até 23:59:59 do mesmo dia da transação;
  • Estorno
    Pedidos desfeitos após 23:59:59 do dia da transação;
  • Estorno Parcial
    Pedidos parcialmente desfeitos após 23:59:59 do dia da transação

É importante lembrar que ao realizar o estorno de uma venda é preciso ter saldo suficiente para cobrir o valor desse cancelamento em sua afiliação. Ou seja, para cancelar uma transação é preciso que você tenha recebíveis, do contrário será negado o pedido de estorno.

Vale ressaltar que caso sua tentativa de cancelamento/estorno não seja aceita pela adquirente, seu pedido ficará com o status "Erro no cancelamento" ou "Erro no estorno". Se você quiser que o Pagar.me tente fazer esse cancelamento/estorno mais uma vez você deve solicitar à equipe de atendimento do PagSeguro que acione a funcionalidade "Retentativa de cancelamento" na sua loja.

Para os pedidos que já estão com o status "Erro no estorno" ou "Erro no cancelamento" você deve entrar em contato direto com o PagSeguro para fazer o cancelamento.

Você pode pegar um comprovante direto no portal do PagSeguro, no detalhe da transação.

Prazo de Cancelamento

Você tem o prazo de até 120 dias para estornar uma captura via API ou no portal do PagSeguro.

Serviços

O Pagar.me em sua integração com o PagSeguro permite que o cliente utilize alguns serviços oferecidos pela adquirente, são eles:

Multicompradores 

Multimeios

Retentativas Online/ Offline

Soft Descriptor

O PagSeguro permite que o lojista envie um texto complementar que será impresso na fatura do comprador junto com a identificação do nome da loja que consta na conta PagSeguro. Este recurso será liberado automaticamente assim que for solicitada a liberação das chaves da API (Em caso de dúvidas, retornar em "Como homologar").

Caso queira entender melhor quais as regras de utilização aconselhamos que você entre em contato com o suporte da adquirente.

Códigos de retorno e erros

Os retornos abaixo são disponibilizados pela própria adquirente de forma genérica, e apenas esta pode dar mais detalhes em relação ao conteúdo. 

Em caso de erro referente ao cartão utilizado na transação, é necessário que o portador do cartão entre em contato com o SAC/Banco emissor do cartão de crédito para maiores esclarecimentos.

Segue a tabela com os códigos de retornados pela adquirente.

Código (payment_response.code)

Mensagem
(payment_response.message)

10000

NÃO AUTORIZADO PELO PAGSEGURO

20000

SUCESSO

20001

CONTATE A CENTRAL DO SEU CARTÃO

20001

SENHA INVÁLIDA

20001

LOJISTA, CONTATE O ADQUIRENTE

20001

DESBLOQUEIE O CARTÃO

20001

SENHA INVÁLIDA UTILIZE A NOVA SENHA

20002

CARTÃO VENCIDO - NÃO TENTE NOVAMENTE

20003

EXCEDIDAS TENTATIVAS DE SENHA.CONTATE A CENTRAL DO SEU CARTÃO

20003

NÃO AUTORIZADA

20003

VALOR EXCEDIDO.CONTATE A CENTRAL DO SEU CARTÃO

20003

QTDADE DE SAQUES EXCEDIDA.CONTATE A CENTRAL DO SEU CARTÃO

20003

EXCEDIDAS TENTATIVAS DE SENHA.CONTATE A CENTRAL DO SEU CARTÃO

20004

REQUISIÇÃO INVÁLIDA

20005

CREDENCIAIS INVÁLIDAS

20006

TRANSAÇÃO INEXISTENTE

20007

VERIFIQUE OS DADOS DO CARTÃO

20007

ERRO NO CARTÃO - NÃO TENTE NOVAMENTE

20008

PARCELAMENTO INVÁLIDO - NÃO TENTE NOVAMENTE

20009

CVV INVÁLIDO

20010

TRANSAÇÃO CANCELADA

20011

EXCEDEU DATA LIMITE PARA OPERAÇÃO

20012

VALOR DA TRANSAÇÃO NÃO PERMITIDO - NÃO TENTE NOVAMENTE

20012

VALOR DIFERENTE DA PRÉ AUTORIZAÇÃO - NÃO TENTE NOVAMENTE

20013

FALHA NA CAPTURA

20014

FALHA NO CANCELAMENTO

20015

SISTEMA INDISPONÍVEL

20016

VERIFIQUE OS DADOS DO CARTÃO

20016

ERRO NO CARTÃO - NÃO TENTE NOVAMENTE

20016

SENHA INVÁLIDA - NÃO TENTE NOVAMENTE

20016

CONTA DESTINO INVÁLIDA - NÃO TENTE NOVAMENTE

20016

CONTA ORIGEM INVÁLIDA - NÃO TENTE NOVAMENTE

20016

ERRO NO CARTÃO - NÃO TENTE NOVAMENTE

20016

TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE

20016

CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE

20016

SAQUE NÃO DISPONÍVEL - NÃO TENTE NOVAMENTE

20016

SUSPENSÃO DE PAGAMENTO RECORRENTE PARA SERVIÇO - NÃO TENTE NOVAMENTE

20017

TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE

20017

CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE

20018

TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE

20018

CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE

20019

REFAZER A TRANSAÇÃO

20019

LOJISTA, CONTATE O ADQUIRENTE

20019

FALHA DE COMUNICAÇÃO - TENTE MAIS TARDE

20019

CONTATE A CENTRAL DO SEU CARTÃO

20020

BANCO DE DADOS INDISPONÍVEL

20021

PEDIDO NÃO REGISTRADO OU CONSULTA FORA DE PRAZO

20022

NÚMERO DE TENTATIVAS EXCEDIDO

20023

ERRO NO INTEGRADOR

20024

TIMEOUT

20025

DATA DE VALIDADE INCORRETA

20033

CARTÃO SUSPEITO

20037

CARTÃO FRAUDADO

20039

TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE

20039

CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE

20039

TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE

20040

CARTÃO CANCELADO

20064

TRANSAÇÃO JÁ EXISTE

20065

CARTÃO NÃO CONFIGURADO

20066

TRANSAÇÃO DESFEITA

20159

NÃO AUTORIZADO

20163

TRANSAÇÃO JÁ CANCELADA

20165

TEMPO ESGOTADO

20166

CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE

20167

TRANSAÇÃO JÁ EXISTE

20168

CONTATE A CENTRAL DO SEU CARTÃO

20169

CARTÃO NÃO PERMITE TRANSAÇÃO INTERNACIONAL

20169

UTILIZE FUNÇÃO CRÉDITO

20169

UTILIZE FUNÇÃO DÉBITO

20170

DADOS INVÁLIDOS

20172

TOKEN INVÁLIDO

20404

ERRO AO EXECUTAR OPERAÇÃO

20999

ADQUIRENTE DESATIVADA

Erro

Descrição

Cenário

40001

required_parameter

Parâmetro obrigatório não enviado

40002

invalid_parameter

Valor do parâmetro inválido

40003

parameter_unknow

Parâmetro desconhecido

40004

rate_limit

Limite de uso da API excedido

40005

idempotency_key_in_use

Chave da idempotência já em uso (72 horas de cache)

40006

unabled_capture

Captura já realizada ou expirada

40007

unabled_refund

Reembolso já realizado, ou valor solicitado acima do permitido

Identificadores de uma transação

Ao entrar em contato com a adquirente, é preciso informar os identificadores TID e NSU:

  • NSU: Número sequencial único é o número de identificação de uma operação de venda realizada com cartões. É atribuído a cada documento fiscal emitido.
  • TID: Transaction ID é um número de identificação (ou de autorização) da transação de e-commerce na operadora.

Central de Atendimento

Canal de atendimento exclusivo para clientes gerenciados. Ao ligar ou acionar via WhatsApp é necessário identificar-se com o seu CNPJ.

3004-2000 (Capitais e Regiões metropolitanas)
0800-723-2000 (Demais localidades, exceto celular)
meugerente@pagseguro.com.br

Para dúvidas técnicas, acione o time de integrações através deste formulário.

Esse artigo foi útil?