Cobrando com cartão de crédito online

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

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

Autenticação

Em nossas APIs utilizamos a autenticação conhecida como Basic Auth.
Para autenticar, você 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 vendas, 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 ela é efetuada e o pagamento realizado, 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 a transação errada, o banco emissor abre uma disputa com o comerciante solicitando a documentação necessária e a prova para remediar o estorno. Se a documentação fornecida for satisfatória, a disputa é simplesmente recusada e o titular do cartão é cobrado com uma taxa de processamento (dispute.succeeded). Se os documentos forem insatisfatórios, o montante do reembolso será fornecido ao titular do cartão e o comerciante será debitado. (Neste caso, entra no cenário de charged_back)

• charged_back - O status indica que o pagamento foi cobrado pelo comprador e o pagamento foi debitado da conta do vendedor. Esse será o ultimo processo após a disputa caso o comprador ganhe.

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.