O produto Antifraude oferecido pela Zoop, visa dar maior segurança nas transações (CNP) de e-commerce realizadas pelos nossos parceiros.
Importante.
Para utilização dessa nova **feature**, é preciso contato com seu atendimento comercial Zoop e cumprir as etapas para aderir ao serviço.
**Tecnicamente será preciso realizar os seguintes passos:**
Cadastrar o comprador (buyer)
Tokenizar o cartão de crédito do comprador
Associar o token de cartão ao comprador
Enviar transação
**Cadastro comprador**
Para que o Antifraude consiga realizar a verificação, as informações abaixo são obrigatórias na criação do comprador:
Nome
Último nome
CPF ou CNPJ
Data de Nascimento
e-mail
Endereço
Cidade
Estado
CEP - O CEP informado deve pertencer a cidade informada
País
Importante.
Caso não informe os dados acima, não será possível a verificação do Antifraude.
Exemplo de request
POST https://api.zoop.ws/v1/marketplaces/:marketplace_id/buyers
**Tokenizando cartão de crédito do comprador**
A tokenização de cartão segue o padrão já conhecido em nossa documentação oficial. Segue abaixo o exemplo:
Exemplo de request:
Post: https://api.zoop.ws/v1/marketplaces/:marketplace_id/cards/tokens
**Associando o token de cartão ao comprador**
Esse passo é fundamental pois o Antifraude **só funcionará** após essa associação.
Exemplo de request:
Post: https://api.zoop.ws/v1/marketplaces/:marketplace_id/cards
TOKEN_ID - é o primeiro ID que é retornado no reponse da tokenização.
BUYER_ID - é o primeiro ID que é retornado no response do cadastro do comprador.
**Comprador com 2 (dois) cartões**
Caso o comprador tenha 2 ou mais cartões, o último associado será o cartão padrão onde bastará informar o **buyer_id** na transação conforme forma de **“utilização 1”** da transação.
Para utilização dos demais cartões, pode-se armazenar o ID do cartão **(id_card)** e utilizar conforme forma de **“utilização 2”** da transação.
**Enviando a transação**
Ao realizar a transação, a Zoop irá primeiramente enviar ao antifraude e, caso haja um retorno satisfatório, finalizar a transação junto a adquirencia.
**Utilização 1 - Cartão do comprador**
Ao enviar a transação, automaticamente será reconhecido o cartão associado ao comprador. Caso o comprador tenha 2 ou mais cartões associados, a Zoop reconhece o último cartão associado como padrão e o mesmo será utilizado na transação.
Exemplo de request:
Post https://api.zoop.ws/v1/marketplaces/:marketplace_id/transactions
**Utilização 2 - Demais cartões do comprador**
O request abaixo deve ser utilizado para os outros cartões, ou seja, diferente do cartão padrão. Neste caso deve-se passar o ID do cartão (id_card).
O ID será obtido no response da associação do token de cartão com ID do comprador, necessitando passar **"number_installments" ** igual a **"1"** na chave **“installment_plan”** mesmo que a transação seja cobrada em uma única parcela (credito a vista).
**Em caso de sucesso a resposta da transação terá as seguintes informações:**
**Caso haja algum problema na verificação do antifraude, a Zoop irá retornar o seguinte erro: **