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 |
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.