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 de status
**Fluxo detalhado**
**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.
**Cancelado (canceled)** - O pagamento foi cancelado / anulado pelo vendedor. As taxas cobradas originalmente também são anuladas.
**Reembolsado (refunded)** - Este evento ocorre quando acontece um reembolso mediante a um cancelamento ou estorno de uma transação.
**Disputa (dispute)** - 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 cliente é cobrado com uma taxa de processamento. Se os documentos forem insatisfatórios, o montante do reembolso será fornecido ao cliente e o comerciante será debitado.
**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.