Dúvidas frequentes (FAQ)

Ao criar uma transação do tipo boleto, é realizado algum contato ou enviado alguma notificação para o comprador (buyer)?

Nas transações por boleto não realizamos nenhuma comunicação com o comprador, fica a cargo do marketplace fazer essa comunicação.

Existe alguma forma de configurar transferências diárias automáticas (quando houver saldo)?

Por padrão (default) o vendedor (seller) quando criado, está configurado para receber automaticamente as transferências de acordo com o seu plano e tipo de venda.

Existe alguma forma de configurar transferências manuais?

Sim, porém é necessário que seja realizada a transferência manualmente via API ou dashboard.

O que é webhook?

Webhook é uma forma de recebimento de informações que são passadas quando ocorre um evento, permitindo que você receba todas as atualizações que ocorrem em seu marketplace em tempo real.

Os webhooks são configurados por marketplace ou seria possível configurar uma URL de webhook por seller?

Os webhooks são configurados por marketplace e tipo de evento. No postback que fazemos para a URL configurada no webhook do evento, irão todos os dados da transação, porém seu sistema será responsável por receber e tratar estes dados.

O boleto criado em qual banco? É registrado?

O boleto é criado na Zoop e registrado pelo banco Itaú.

Vocês tem a opção de pré-autorização no cartão não presente?

Sim, essa informação é passada na transação através da chave "capture:false". Veja mais na referência de API

Como consigo saber quando uma transação de cartão de crédito será paga? Como vejo se o valor já está na conta do seller?

Nós fazemos a liquidação para os estabelecimentos de acordo com a condição vinculada ao plano de recebimento escolhido no momento da venda. Temos dois serviços na API, um para consultar a listagem de lançamentos futuros do seller e mais uma para listar os pagamentos realizados, sendo também informado a data de previsão de recebimento no objeto transaction, no atributo expected_on. Veja mais na API de Transactions

Quando a transação não chega a adquirente, o que pode ocorrer?

Quando o emissor demora mais do que este tempo para responder, ou então a comunicação é perdida por qualquer motivo, você recebe um HTTP Error 408 na requisição, e a transação entra na fila para ser revertida. O processo de desfazimento é uma rotina automática que garante que a transação seja desfeita no emissor, sendo o status da transação alterado para reversed quando temos a confirmação do desfazimento do emissor.

Como é feito o envio de documentação para cadastrar um novo vendedor (seller)?

Esse processo pode ser feito via dashboard ou API

Como um vendedor (seller) habilitado recebe o saldo das transações realizadas?

Estando habilitado o vendedor recebe os valores transacionados em sua conta Zoop.

Nas transações realizadas, a API retorna um array de taxas contendo mais de uma taxa. Por que é listada mais de uma taxa se cada cliente está associado a apenas um plano?

{
    "fee_details": 
    [{
        "amount": "1.83",
        "prepaid": true,
        "currency": "BRL",
        "type": "custom_credit_fee_d0",
        "description": "Custom prepaid card-present credit fee" *(MARKUP PARCEIRO)
    },
    {
        "amount": "2.06",
        "prepaid": true,
        "currency": "BRL",
        "type": "zoop_custom_credit_fee_d0",
        "description": " Zoop Custom prepaid card-present credit fee" (TAXA ZOOP)
    }]
}

Na Zoop, o plano possui 2 taxas: a taxa Zoop e o markup do parceiro. Ambas estão descritas conforme a imagem acima. Para realizar a consulta utilizar esse endpoint

Quais são os mínimos obrigatórios para credenciar um vendedor (seller) na Zoop?

A API precisa validar a identidade do vendedor para credenciá-los junto a plataforma da Zoop e consequentemente ao marketplace, o que requer, no mínimo, o nome legal, o endereço residencial, CPF/CNPJ e a data de nascimento e MCC (Merchant Category Code), sem esses dados o seller não será credenciado no plataforma. Estas informações serão verificadas em relação a fontes de dados externas.

Updated 3 months ago


Dúvidas frequentes (FAQ)


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.