Central de Ajuda

Cartão de Crédito | SafraPay

A SafraPay é uma adquirente de meios de pagamentos. Ela processa pagamentos de cartão de crédito das seguintes bandeiras integradas com o Pagar.me: Visa, Mastercard, Elo, Amex, Hipercard.

Para saber mais sobre cartão de crédito, acesso o nosso artigo Cartão de Crédito | Saiba mais sobre esse meio de pagamento.

Como contratar

Para se credenciar a SafraPay é necessário entrar em contato diretamente com eles pelo número (11) 3175-8248.

Se você já tiver uma maquininha da SafraPay, ao falar com o atendente deve explicar que já possui um ponto de venda cadastrado e necessita de uma afiliação SafraPay para o seu estabelecimento no e-commerce.

Como homologar 

Depois de contratar o serviço você deverá nos passar os dados abaixo:

  • Merchant Token;
  • EC / Merchant ID;

Assim que dermos o “OK” do cadastro recomendamos que você realize um pedido teste com um valor de no máximo R$10,00 para verificar se o fluxo com a adquirente está funcionando de forma adequada.

Autorização e Captura

A SafraPay permite: autorização e captura automática, pré-autorização e captura posterior e ainda uma captura parcial da transação.

O prazo máximo para realizar a captura posterior de uma autorização é de 7 dias corridos após a data da autorização. Por exemplo, se uma autorização ocorreu em 01/12 às 15h20m45s, o limite para captura será às 15h20m45s do dia 8/12.

Caso a captura não seja feita neste prazo a autorização expira e não será mais possível capturar essa transação. No dashboard esta transação permanecerá com o status "Autorizada pendente de captura".

Cancelamento e Estorno

É possível realizar um cancelamento via API ou no dashboard. Existe uma pequena diferença entre essas duas funções:

  • Cancelamentos
    Pedidos desfeitos até 23:59:59 do mesmo dia;
  • Estornos
    Pedidos desfeitos após 23:59:59 do dia da captura.
  • 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 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 mais uma vez você deve pedir pra nossa equipe de atendimento acionar a funcionalidade "Retentativa de cancelamento" na sua loja.

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

Serviços

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

Chargeback

O Pagar.me não realiza tratativa de chargeback, sendo esse serviço exclusivo da adquirente.

Caso queria contestar ou entender melhor sobre o processo de chargeback aconselhamos que você entre em contato com o suporte da adquirente.

Zero dólar

Zero dollar auth é uma funcionalidade nova nas adquirentes que funciona como um verificador de cartão.

A validação é realizada sem a necessidade de criar uma transação, assim, o comprador não é notificado da verificação do cartão e a transação só é criada em caso de sucesso ou você receberá um retorno de erro.

As bandeiras habilitadas para Zero Dólar na SafraPay2 são Visa, Mastercard e Elo.

Para liberar essa funcionalidade você deve entrar em contato com o suporte da adquirente solicitando liberação do serviço, caso exista, e posteriormente avisar nosso time de suporte para que haja a liberação.

Antecipação

O Pagar.me não realiza antecipação de recebíveis, sendo esse serviço exclusivo da adquirente.

Caso queria contestar ou entender melhor sobre o processo de antecipação aconselhamos que você entre em contato com o suporte da adquirente.

Soft Descriptor

A SafraPay 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 no cadastro Safra.

Caso queria liberar esse serviço ou entender melhor quais as regras de utilização aconselhamos que você entre em contato com o suporte da adquirente.

Códigos de retorno

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. Para acessar estas informações de maneira mais aprofundada, você pode clicar no PDF em anexo, a partir da página 83.

SafraPay - E-Commerce - Manual de Integração

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 do banco emissor do cartão de crédito para maiores esclarecimentos.

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

Código de retorno
 Mensagem
1 Uma propriedade obrigatória ou condicional está vazia, apenas com espaços em branco, apenas com zeros ou nula.
2 Merchant Token inválido.
3 Cartão não suportado.
4 Cartão não encontrado na wallet.
5 Mês de expiração do cartão inválido.
6 Ano de expiração do cartão inválido.
7 Cartão expirado.
8 Comprador não encontrado na null.
9 Número de parcelas inválido.
10 Erro de comunicação com a adquirente. Tentar mais tarde ou entrar em contato com a null.
11 Adquirente inválida.
12 Tipo de pagamento inválido.
13 Prioridade do tipo de pagamento inválida.
14 Taxa percentual inválida.
15 Valor inválido.
16 Cobrança cancelada.
17 Cobrança não encontrada na null.
18 Data inválida.
19 Frequência de recorrência inválida.
20 Plano não encontrado na null.
21 Intervalo de datas inválido.
22 ID do cartão inválido.
23 Recebedor não encontrado.
24 Opção de enumerador inválida ou não suportada.
25 Banco não suportado.
26 Comprador não pode fazer ou requisitar a operação.
27 Erro na cobrança recorrente.
28 Erro ao executar os comandos.
29 Usuário não encontrado na null.
31 Data de início é mais recente que a data final.
32 CNPJ inválido.
33 E-mail inválido.
34 ID da adquirente inválido.
35 Token da loja pai inválido.
36 Operação não permitida para a loja.
37 Operação não permitida.
38 ID da loja inválido.
39 Permissão não encontrada.
40 PAN encriptado está ausente.
41 PAN sequence number (5F34) inválido.
42 Terminal não encontrado na null.
43 Loja não encontrada na null.
44 Erro na senha.
45 Propriedade inválida (genérico).
46 Tamanho da página ausente.
47 Numero da página atual ausente.
48 Data e hora inválidos.
49 Transação não suportada.
50 Erro interno de atualização.
51 Não foi possível se conectar ao gateway de pagamentos.
52 A assinatura foi desativada.
53 A assinatura foi desativada devido a quantidade excessiva de não autorização.
54 Valor excede o limite.
55 Assinatura não encontrada.
56 Cartão inválido.
57 Histórico de comunicação da loja não encontrado.
58 Operação não suportada pela adquirente.
59 ID de conciliação já existe.
60 ID de conciliação não existe.
61 Data requisitava é mais recente que a data atual.
62 Erro de requisição no Safrapay.
63 O cartão é diferente da transação original.
64 Transação não pode ser cancelada.
65 Falha no upload do arquivo .OFX.
66 Valor requisitado é maior que o saldo atual do recebedor.
67 Data requisitada é mais antiga que a data atual.
68 Valor de transferência inválido.
69 Data requisitava é mais recente que a data atual.
70 Data requisitada é mais antiga que a data atual.
71 Formato do GUID inválido.
72 Status inválido para cancelamento de pedido de transferência. Tente novamente mais tarde.
73 ID do pedido de transferência não encontrado.
74 Número de transferências por dia excedido.
75 ID da linha de extrato no arquivo .OFX é inválida.
76 Cliente já foi credenciado.
77 ID do cliente é inválido.
78 ID do cliente não existe.
79 Valor não aceito. O valor deve estar no intervalo especificado na mensagem de erro.
80 Recebedor já possui conta vinculada.
81 Checkout / link de pagamento expirado.
82 Erro ao salvar dados.
83 Cobrança não cancelada.
84 Checkout / link de pagamento não encontrado.
85 ID da taxa não encontrado.
86 Ordem de transferência está em processamento.
87 Nenhum plano de taxas cadastrado.
88 Conciliação não cadastrada.
89 O documento do comprador é inválido para o e-mail requisitado. Isso pode ocorrer se o e-mail já foi cadastrado para um comprador, com outro CPF / CNPJ.
90 Status da transação conciliada é inválido.
91 Código da bandeira do cartão é inválido.
92 Conta bancária não encontrada para o pedido de transferência.
93 Conta bancária inválida para o pedido de transferência.
94 O valor solicitado é inferior ao saldo total disponível, descontando o valor total das ordens de transferência em progresso no momento.
95 Nenhum recebedor encontrado.
96 Cobrança não elegível para split.
97 Tipo de ajuste inválido.
98 Razão do ajuste inválida.
99 Tamanho da lista é inválido. Verifique o tamanho suportado na mensagem de erro.
100 CNPJ já cadastrado.
101 Cobrança já autorizada.
102 Valor inválido (genérico).
103 Movimentação de ajuste já processada.
104 Configuração de desconto do boleto está inválida.
105 Configuração de desconto do boleto está inválida.
106 Item do plano com valor inválido.
107 Erro na configuração da fatura.
108 Erro ao requisitar parâmetros da adquirente.
109 Erro de ativação na adquirente.
110 Erro na mensageria ISO-8583.
111 Erro ao fazer login no portal null.
112 Terminal não está ativado na adquirente.
113 Transação por boleto não suportada.
114 Fatura não encontrada pelo ID.
115 Saldo atual insuficiente, descontando a taxa de transferência eletrônica.
116 Código do banco inválido.
117 Agência inválida.
118 Tamanho da agência inválido.
119 Código de verificação da agência inválido.
120 Conta bancária inválida.
121 Tamanho da conta bancária inválido.
122 Código de verificação da conta bancária inválido.
123 Dados bancários em branco.
124 Tipo de conta bancária inválido.
125 Não foi possível se comunicar com o banco.
126 Erro no desfazimento.
127 E-mail já existe.
128 Comprador não encontrado pelo documento (CPF / CNPJ).
129 CPF inválido.
130 Código de área do telefone é inválido.
131 Código do país do telefone é inválido.
132 Telefone é inválido.
133 Documento é inválido.
134 A origem da requisição é inválida para a operação.
135 Informação de parcelamento é inválida.
136 Bandeira do cartão não suportada pela adquirente.
137 Lançamento futuro não encontrada.
138 Lançamento futuro já existe.
139 Tipos de pagamento suportados não encontrados.
140 Webhook já cadastrado.
141 URL inválida.
142 Origem da requisição não suportada.
143 Modo de entrada do cartão não suportado.
144 Código de transação não suportado, verifique os códigos de transação suportados.
145 A loja não pode configurar antecipação.
146 Acesso negado ao checkout de pagamentos.
147 Não foi possível processar a transação. Tente novamente em alguns minutos ou entre em contato com a loja.
148 Código de processamento não suportado, verifique os códigos de processamento suportados.
149 O valor mínimo da parcela não pode ser maior que o valor do Link de Pagamento ou Checkout.
150 O webhook informado não foi encontrado.
151 Número de série do terminal é inválido.
152 NSU inválido.
153 Loja requer motor de antifraude cadastrado.
154 Não foi possível alterar a data de vencimento do boleto.
155 Recibo disponível apenas se a transferência tiver o status de realizado.
156 Erro no emissor que foi registrado no boleto, contate um administrador.
157 Não foi possível emitir o boleto por falta de informações referente ao endereço do comprador. Entre em contato com a loja para atualizar seu cadastro.
158 Não há recebedor registrado ao CPNJ.
159 Não foi possível criar a fatura.
160 Extensão do arquivo não suportada pelo descompactador.
161 Link de pagamento expirou porque excedeu o número de transações negadas.
162 Não é possível reemitir boleto pois a fatura ainda não está expirada.
163 Normalização de arquivos da Carga de Parâmetros não suportou os arquivos recebidos.
164 Informações da transação original não encontradas.
165 Necessário de envio de mensagem com a perna de MTI anteriormente.
166 Parâmetros do terminal não encontrados, efetue a primeira Carga de Parâmetros ou contacte um administrador.
167 Sub-adquirente não encontrada.
168 Produto da Sub-adquirente não encontrado.
169 Sub-adquirente deve ter ao menos 'x' produto
170 Produto 'x' duplicado.
171 Já foi criado uma Sub-adquirente com esse lojista e adquirente.
172 Já existe um termo de uso cadastrado com esse mesmo nome.
173 O termo de uso informado não foi encontrado.
174 O plano de taxas de boleto não foi encontrado.
175 Nenhum lojista foi encontrado com as credenciais informadas.
176 Não há segmento para o seu MCC 'x'.
177 Lojista não está habilitado a aceitar transações.
178 O valor mínimo para criação de link de pagamento de boleto é de 'x'.
179 O plano de taxas não foi encontrado.
180 Cobrança com ID 'x' já foi cancelada.
181 O lojista deve possuir um plano de taxas ativo.
182 Sem chaves lógicas disponíveis, comunique-se com a adquirente responsável pela geração das novas chaves e solicite a importação das novas chaves ao suporte da Safrapay.
183 Essa configuração de boleto já existe.
184 Essa configuração de adquirente já existe.
185 O plano de taxas selecionado não é suportado pelo MCC do lojista.
186 A adquirente 'x' não suporta transações de 'x'.
187 O link para pagamento foi cancelado.
188 A adquirente 'x' não suporta transações de valor 0.
189 A adquirente 'x' não suporta cancelamento parcial.
190 O estabelecimento 'x' não possui contato telefônico cadastrado, favor entrar em contato com o administrador.
191 A adquirente não possui o serviço de antecipação spot.
192 Nenhuma transação de liquidação foi encontrada.
193 Já existe uma solicitação de antecipação para o TID 'x'.
194 Nenhuma transação foi encontrada.
195 Boleto só pode ser cancelado um dia após ser criado.
196 Nenhuma conta encontrada.
197 Pagamento de conta já processado.
198 Profile do Adquirente não encontrado.
199 Parceiro não identificado. Entre em contato com o suporte.
200 Parceiro não está atribuído para esta loja. Entre em contato com o suporte.
201 Código de autenticação inválido.
202 Checkout com ID 'x' não encontrado.
203 O token passado não é válido.
204 Venda com o ID 'x' não encontrada.
205 Tamanho de arquivo não permitido, o tamanho deve estar entre 'x' e 'y'.
206 Extensão não permida, apenas arquivos com a extensão 'x' são permitidos.
207 Quantidade de linhas no arquivo não permitida, apenas arquivos que possuem a quantidade de linhas entre 'x' e 'x' são permitidos.
208 Formato incorreto em uma ou mais linhas. Posição da linha: 'x'. Contéudo da linha: 'x'.
209 Arquivo de Venda com o ID 'x' não encontrado.
210 Já existe uma venda com esse NSU 'x' na adquirente'x'.
211 Esse arquivo já foi importado.
212 A Adquirente 'x' não é conhecido.
213 Não é possível importar um novo arquivo. Você possui arquivos pendentes para conciliar!.
214 Atualizar tabelas do terminal.
215 Transação referida inválida ou não existe.
216 A transação não foi encontrada.
217 Cancelamento parcial não permitido.
218 Captura parcial não é permitida.
219 Erro ao cancelar transação. Adquirente retornou código 'x' com a mensagem de erro 'x'.
220 Plano de taxas não pode ser associado ao Estabelecimento.
221 O registro de chargeback não foi encontrado.
222 O formato do ID é inválido.
223 O arquivo de comprovante da abertura de disputa não foi encontrado.
224 O Passaporte 'x' é inválido.
225 Erro no processo de validação do Captcha.
226 O visitante já foi cadastrado.
227 Visitante {0} não foi encontrado.
228 Visitante já confirmou a inscrição.
229 Documento ou email já cadastrados como usuário ou loja.
230 Nenhuma configuração de 3DS cadastrada.
231 UnreachableThreeDomainSecureProvider.
232 Autenticação negada pelo provedor 'x'.
233 O arquivo solicitado não foi encontrado no banco de dados.
234 O registro solicitado não foi encontrado no banco de dados.
235 O evento solicitado não foi encontrado no banco de dados.
236 O Relatório financeiro não foi encontrado.
237 Falha no upload do arquivo para o bucket.
238 O arquivo de conciliação solicitado para download não foi encontrado.
239 O parceiro não foi encontrado.
240 A propriedade 'TransactionMac' na requisição não é válida. Deve estar de acordo com as informações passadas.
241 O integrador 'x' não pôde ser encontrado.
242 Não foi possível estabelecer comunicação com o tokenizador 'x'.
243 Valor do link de pagamento maior que o saldo disponível.
244 Integração para sensibilização de saldo desabilitada para o estabelecimento 'x'
245 Tabela de chaves do adquirente não encontrada.
9999 Outros.

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

Caso deseje entrar em contato com o suporte da adquirente você pode ligar para o número abaixo:

  • (11) 3175-8248

Ou através do próprio site da adquirente: www.safra.com.br

Esse artigo foi útil?

Artigos Relacionados

NAVEGAÇÃO

SUPORTE

PAGAR.ME

Stone logo