É possível utilizar o provedor de sandbox da Malga para o controle dos resultados de transações de teste com retornos de antifraude. Este controle é feito através do documento de identidade do customer enviado junto aos dados de fraudAnalysis. O número da identidade pode ser gerado a partir de qualquer gerador de identidades, seguindo a seguinte regra:

Documento	Autorizado?	Status	Declined Code
Final 0	NÃO	Pendente; Aprovado após 2 minutos	Nulo
Final 1	SIM	Aprovado	Nulo
Final 2	NÃO	Falha	Aleatório `timeout` ou `processing_error`
Final 3	NÃO	Erro no antifraude (análise falha)	Nulo
Final 9	NÃO	Pendente; Reprovado após 2 minutos	Nulo
Qualquer outro final	NÃO	Reprovado	Nulo

Os finais 0 e 9 simulam o antifraude assíncrono: a análise começa pendente e o veredito chega sozinho cerca de 2 minutos depois. A cobrança então segue as options cadastradas para o provedor, como captureOnApproved e refundOnReproved.

Para escolher o veredito e o momento do assíncrono você mesmo, use o endpoint de alteração de status de antifraude e observe as várias alterações possíveis de status na transação, dependendo das options cadastradas para o provedor.

Para configurar o antifraude de sandbox, adicione o provedor antifraude "ANTIFRAUD_SANDBOX" a um merchant da sua conta de sandbox que já use o provedor de transação "SANDBOX", e determine o comportamento automático do antifraude com as flags do objeto options.

As chaves de sandbox não criam merchants: POST /v1/merchants devolve 403 Forbidden nesse ambiente. Também não adianta enviar providers no PATCH /v1/merchants/{id}, porque o campo é ignorado na atualização. Para adicionar o antifraude, use o endpoint de providers descrito abaixo.

Exemplo de cadastro do provedor de antifraude de sandbox

Consulte o id do merchant em GET /v1/merchants e envie-o em merchantId:

curl --location --request POST 'https://sandbox-api.malga.io/v1/providers' \
--header 'X-Client-Id: <YOUR_CLIENT_ID>' \
--header 'X-Api-Key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '
{
    "merchantId": "<YOUR_MERCHANT_ID>",
    "name": "antifraud_sandbox",
    "priority": 1,
    "credentials": {
        "type": "ANTIFRAUD_SANDBOX",
        "apiKey": "<YOUR_API_KEY>"
    },
    "options": {
        "type": "ANTIFRAUD",
        "captureOnError": false,
        "refundOnError": false,
        "captureOnApproved": true,
        "refundOnReproved": true
    }
}'

A resposta, com status 201, traz o id do provedor criado. Para remover o antifraude do merchant, use esse id:

curl --location --request DELETE 'https://sandbox-api.malga.io/v1/providers/<PROVIDER_ID>' \
--header 'X-Client-Id: <YOUR_CLIENT_ID>' \
--header 'X-Api-Key: <YOUR_API_KEY>'

A remoção devolve 204 No Content. Para mudar as flags de options sem remover o provedor, use o endpoint de atualização de provider.

Comece na Malga

Conexões

Guias

Serviços adicionais

Testando em Sandbox

Exemplo de cadastro do provedor de antifraude de sandbox

​Exemplo de cadastro do provedor de antifraude de sandbox

Exemplo de cadastro do provedor de antifraude de sandbox