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.

(Script tags will be stripped)

1460


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.