Konduto

Get started with Konduto

The goal of this manual is to help you understand how to integrate Konduto with DEUNA.

Before you begin, you need to complete the following steps to certify your account and credentials.

Test Environment Certification Process

You will be able to use Konduto antifraud provider with Deuna

Requirements

1. API test credentials:
   1. Public Key
   2. Secret Key
2. Dashboard test access
   1. email
   2. password

Start the test environment certification

1. Set up Konduto’s Dashboard

1. Enter to https://app.konduto.com/

2. Input Dashboard credentials

3. Review your API Keys

   1. Select “Stores” under the user icon

      

   2. Select the “Edit” button from your Store (should have been created by your Konduto’s KAM)

      

   3. Select “Keys”

      

2. Create rules

1. Create rules for approve, deny, and manual review

   1. Enter to the Rules tab

      

   2. Select “New Rule”

   3. Create the Always Accept Rule with the following values

      

   4. Create the Always Review Rule with the following values

      

   5. Create the Always Reject Rule with the following values

      

3. Configure the webhook:

1. Select “Stores” under the user icon

   

2. Select the “Edit” button from your Store (should have been created by your Konduto’s KAM)

   

3. Select “Preferences”

   1. Paste https://api.stg.deuna.io/post-transactions/konduto in the textbox if the tests will be done in Deuna’s Staging Environment
   2. Paste https://api.sandbox.deuna.io/post-transactions/konduto in the textbox if the tests will be done in Deuna’s Sandbox Environment
   3. Paste https://api.deuna.io/post-transactions/konduto in the textbox if the tests will be done in Deuna’s Production Environment
   4. Select “Save”

4. Setup DEUNA’s Test Environment

1. Go to https://admin.deuna.io/ and enter the credentials provided by the DEUNA team.

2. Select Test Mode

   

3. In the DEUNA admin, go to the left menu, select Payments -> Connections

   

4. In the search engine, type "konduto" and press the "Connect" button

   

5. Fill out the information obtained from your Konduto Dashboard or KAM and press Connect

   

6. At the end of the configuration you will see a screen indicating that it has already been configured

5. Activate Manual Review

1. In the DEUNA admin, go to the left menu, select Settings -> Merchant

2. In General Fraud Settings enable both “Enable Manual Review” and “Enable Automatic Operations Execution”. Is important to have these two options enabled to allow Deuna to automatically perform the refund, capture, or void after the antifraud post authorization decision.

   

6. Configure Konduto as Post Authorization Fraud Processor

1. Even though Konduto works for both pre and post authorization, Konduto suggest to be configured Post Authorization.

2. Select Payments→ Payment Strategy

3. After selecting the Processor routing strategy, and enable the Post Authorization Fraud Analysis button

4. Select “Konduto” as Provider

   

5. Select “Save”

7. Configure Device Fingerprinting in VTEX

1. Depending on your integration type you should follow one next steps in coordination with your Deuna’s TPM:

2. VTEX:

   1. Enter to https://docs.deuna.com/docs/vtex-como-configurar-device-fingerprint-widget-v2 and follow the configuration steps

   2. For Konduto, use the following information will be used in the object fraudCredentials:

      JSON

          fraudCredentials: JSON.stringify({ 
      	    KONDUTO: {
              "publicKey": "Konduto Public Key"
            }
         })
      

   3. The value to use is the Store’s Public Key, shared by your Konduto’s KAM or obtained in the dashboard under the Store settings in the “Keys“ tab

3. Direct API Integration

   1. Enter to https://docs.deuna.com/docs/integrar-device-fingerprint-de-mercadopago-en-tu-comercio#cuando-el-comercio-está-integrado-a-deuna-vía-direct-api and follow the configuration steps

   2. For Konduto, use the following information will be used in the object fraudCredentials:

      JSON

                fraudConfig: {
                  MERCADOPAGO: {}, //example of a PSP that requires fingerprinting
                  KONDUTO: {
      	            publicKey: "Konduto Public Key"
                  }
                },
      

   3. The value to use is the Store’s Public Key, shared by your Konduto’s KAM or obtained in the dashboard under the Store settings in the “Keys“ tab

4. Payment Widget not Payment Link: Currently Device fingerprint is not available for these integrations

8. Perform Integration Tests

1. Perform the following integration tests:

   #	Case	Rule	Use Case	Acceptance requirements
   1	Automatic approval	Transaction with DEUNA using the email [email protected]	1. The buyer use the email [email protected] 2. Select DEUNA to make the payment. 3. Fill out the information and complete the purchase.	1. The transaction is approved in DEUNA. 2. The transaction is approved in Konduto. 3. The transaction is approved in your store.
   2	Automatic disapproval	Transaction with DEUNA using the email [email protected]	1. The buyer use the email [email protected]. 2. Select DEUNA to make the payment. 3. Fill out the information and complete the purchase.	1. The transaction in DEUNA is denied. 2. The transaction is denied on Konduto. 3. The transaction is disapproved in your store.
   3	Manual Analysis - Manually Approved	Transaction with DEUNA using the email [email protected]	1.The buyer use the email [email protected]. 2. Select DEUNA to make the payment. 3. Fill out the information and complete the purchase. 4. The merchant logs into their Konduto and DEUNA panel to validate the pending transaction. 5. The merchant manually approves the transaction.	1. The transaction in DEUNA is approved. 2. The Konduto transaction is approved. 3. The transaction in your store is approved.
   4	Manual Analysis - Manually Declined	Transaction with DEUNA using the email [email protected]	1.The buyer use the email [email protected]. 2. Select DEUNA to make the payment. 3. Fill out the information and complete the purchase. 4. The merchant logs into their Clearsale and DEUNA panel to validate the pending transaction. 5. The merchant manually declines the transaction.	1. The transaction in DEUNA is rejected. 2. The transaction on Konduto is rejected. 3. The transaction in your store is rejected.
   5	Manual Analysis - Keep it in Analyzing state	Transaction with DEUNA using the email [email protected]	1.The buyer use the email [email protected]. 2. Select DEUNA to make the payment. 3. Fill out the information and complete the purchase.	1. The transaction in Konduto remains as Pending.

   
   

2. Manual Approval or Denial

   1. Enter to the Konduto Dashboard https://app.konduto.com/login

   2. Select the “Orders” tab

   3. Select the transaction in “Pending” status

   4. Find the “Pending” label and select it (Change Status)

      

   5. From the Dropdown list select the options “Approved”, “Declined”, or in case it applies: “Fraud”, “Not Authorized”, or “Cancelled”.

      

   6. If desired, input comments and select “Save”.

9. Send Evidence of Testing to Konduto

1. If required, send evidence to once the tests are complete, in coordination with Deuna's TPM, send an email to Konduto with the evidence of the performed transactions.

   Estimado equipo de Konduto,
   
   Adjuntamos evidencia de las pruebas con DEUNA en ambiente de pruebas:
   
   1. Aprobación automática:  1xxxxxxx123
   2. Reprobación automática: 1xxxxxxx123
   3. Análisis Manual - Aprobado Manualmente: 1xxxxxxx123
   4. Análisis Manual - Declinado Manualmente: 1xxxxxxx123
   5. Análisis Manual - Mantenerlo en estado Pending: 1xxxxxxx123
   
   Esperamos su confirmación para realizar la activación en producción.
   
   Saludos,
   
   

2. Konduto will respond indicating that you can move forward with the process in production.

Productive Environment Certification Process

Requirments

• You completed the certification in a testing environment
• Have access to a productive Konduto account (email and password)
• You have access to productive Konduto API Keys (Public Key & Secret Key)
• You have access to productive Deuna credentials
• Have a real card to take the tests

Start the product environment certification

1. Configure Konduto Dashboard

1. Enter to https://app.konduto.com/
2. Input Dashboard credentials
3. Configure the webhook:
   1. Select “Preferences”
   2. Paste https://api.deuna.io/post-transactions/konduto in the textbox if the tests will be
   3. Select “Save”

2.Configure Konduto in DEUNA

For the production environment, the process is the same for obtaining Konduto’s credentials and configuration in the DEUNA admin, but using the production URLs and credentials:

• DEUNA: https://admin.deuna.com/
• Create Konduto as Fraud Processor using the API production Credentials
• Create a Payment Strategy using Konduto as Post Auth antifraud processor

3. Configure Device Fingerprinting in VTEX

1. Enter to https://docs.deuna.com/docs/vtex-como-configurar-device-fingerprint-widget-v2 and follow the configuration steps
2. Use Konduto’s Public Key for productionin the object fraudCredentials

4. Perform productive test transactions

• Important: You must have a card available to perform productive tests.
• As in the testing process, you must send evidence to Konduto. It is recommended that you send evidence of at least three transactions to Konduto once set up and activated.

5. Send evidence to Konduto of productive tests

Finally, in coordination with your Deuna’s TPM, you must send the productive transactions to Konduto in the same email to validate that everything is correct.