Cobrando com cartão de crédito online

A Zoop permite que você cobre cartões de crédito de diversas formas dando flexibilidade para construir a sua própria plataforma de pagamentos.

Aqui você conhecerá o que precisará para realizar uma transação em nossas APIs, e conseguir começar a operar:

Autenticação

Em nossas APIs utilizamos a autenticação conhecida como Basic Auth.
Para autenticar, deverá utilizar a sua chave de acesso (conhecida como zpk).

No processo de onboarding, você receberá um e-mail com os links para o acesso as chaves para se autenticar nas APIs. Uma para o ambiente de testes e outra para o ambiente de produção.

❗️

Sobre reenvio de chave

Caso o link não esteja mais disponível e você não tenha mais sua chave, solicite ao suporte ([email protected]).

Credenciamento

Para realizar transações, o seu marketplace precisa de vendedores cadastrados. Por isso, o primeiro passo para fazer uma venda na Zoop, é garantir que você já tem um vendedor cadastrado.

❗️

Importante!

Não utilizar dados reais no ambiente de teste (sandbox), para evitar um futuro contratempo com o seu cliente.

Realizando transação

Uma transação de pagamento digital, é uma transação realizada em que o titular do cartão não fornece fisicamente o cartão para o comerciante no momento em que será realizada a cobrança, como exemplo desse tipo de transação, temos a compra efetuada via web sites e aplicativos através do serviço de Pagamentos Digitais da Zoop.

Fluxo detalhado (eventos relacionados)

• Novo (new) - A transação foi gerada (estágio inicial da transação)

• Criado (created) - A transação foi criada.

• Sucesso (succeeded) - O pagamento foi autorizado com sucesso.

• Falhou (failed) - A transação falhou.

• Revertido (reversed) - Uma reversão ocorre antes que a transação tenha sido confirmada.

• Pré-autorizada (pre-authorized) - Realiza reserva dos valores de um cartão de crédito.

• Cancelado (canceled) - O pagamento foi cancelado total, parcial ou anulado pelo vendedor. As taxas cobradas originalmente também são anuladas.

• Disputa (disputed) - Quando o titular do cartão envia uma queixa comunicando-se com o banco emissor sobre o não reconhecimento de uma transação, o banco emissor abre uma disputa com o comerciante solicitando a documentação necessária e a prova para remediar o estorno. A transação fica em disputa por 7 dias corridos, pois é o prazo para enviar os documentos de defesa por parte do estabelecimento.

• Disputa Vencida (disputed.succeeded) - No período que a transação entra em disputa até o 7 dia, o banco emissor analisando a documentação e dando o comerciante como vencedor, a transação passa para sucesso.

• charged_back - Após os 7 dias corridos em que a transação esteve nos status "disputed", no 8º dia a transação é alterada para chargeback, mesmo que os documentos tenham sido enviados. Após 120 dias, é possível verificar se houve alguma mudança nos status da transação. Se o banco, após analisar os documentos, considerar a transação como chargeback, os status da transação permanecerá o mesmo. Caso contrário, a transação voltará para o status sucesso, o valor devolvido ao estabelecimento comercial e o marketplace recebe a notificação via e-mail.

• Reversão (charged_back.reversed) - Dentro do período dos 120 dias, o banco emissor retorna a análise considerando comerciante como vencedor. Nesse cenário a transação sai do status charge_back para sucesso novamente.

Para maiores informações sobre fluxo chargeback, acesse a nossa central de ajuda ou entre em contato com o nosso suporte pelo e-mail [email protected]
Link central de ajuda: O que é chargeback?

Saiba mais:

❗️

Valor mínimo de transação

O valor mínimo para uma transação é de R$ 1,00.

❗️

Atenção

A chave "reference_id" deve ter uma valor único em cada requisição de transação, não podendo ter seu valor informado repetido.