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é-captura no cartão não presente?

Sim, essa informação é passada na transação através da chave "capture". 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 Agenda de recebimentos do seller
e outra 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 adiquirente, o que pode ocorrer?

Quando uma solicitação de autorização é feita, o registro da transação é criado com status new, e a requisição de autorização (o post no /transactions) fica em espera (waiting) até que a transação seja aprovada (succeeded) ou negada (failed) no emissor, sendo o tempo máximo deste processamento 40s. 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

Quem faz o processo de ativação de um cliente? Como passar o seller de pending para enabled ou active?

O processo de ativação de um estabelecimento é feito em duas etapas.

1° etapa: ocorre logo após o envio da documentação, levando geralmente de 1 a 3 dias. Uma vez que você seja aprovado nesta etapa, o status de seu cadastro passa a “Enabled” e você já pode começar a transacionar, mesmo que ainda se encontre em processo de ativação até a conclusão da segunda e última etapa.

2° etapa: essa etapa geralmente leva de 1 a 5 dias para ser finalizada, feito isso o processo de credenciamento é considerado concluído e o status de seu cadastro passa a “Active”. Caso ocorra uma rejeição, haverá um impedimento temporário ou definitivo para a realização de novas transações.

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

Estando habilitado ele recebe os valores transacionados em sua conta Zoop (conta gráfica).

Quanto tempo o dinheiro ficaria disponível na conta Zoop? Tem como configurar a nível de API quando ele vai receber (com antecipação ou sem antecipação)?

Por padrão, a liquidação dos recebíveis é feita diariamente para a conta bancária do estabelecimento, desde que ele tenha configurado uma conta para recebimento. Caso ele não tenha conta bancária cadastrada o saldo fica acumulado por tempo indeterminado. Pode ser configurado a frequência com que o pagamento é feito para o seller, o padrão é diário, porém existe a possibilidade de ser semanal, ou mensal. política de recebimento

Conseguimos fazer transferências entre contas Zoop?

Existe a possibilidade de fazer transferências entre contas de sellers do mesmo marketplace.
Veja mais na API de Transferências P2P

Existe a possibilidade de divisão dos valores de uma transação?

Sim, é possível realizar uma divisão utilizando o produto split

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

Updated 21 days 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.