Documentation

Clearsale

Suggest Edits

Integrate Clearsale pre-authorization in your application with DEUNA.

Requirements

The following content lists the requirements for a successful integration with Clearsale.

Test environment requirements

You need the following credentials to test the integration with Clearsale:

  • Clearsale account
  • Access to Clearsale test store
  • Test products with the following configured amounts:
    • One product with amount equal to or less than 50.
    • One product with amount greater than 50, and less than or equal to 100.
    • One product with amount less than 100.

📘

During the integration process, you will have a dedicated sales engineer or technical operations engineer to perform tests in sandbox and production environments.

Production requirements

You need the following credentials to complete the integration in production with Clearsale:

  • You completed the certification in test environment
  • Have access to a productive Clearsale account
  • Have a real card to perform tests

📘

If you have a KAM from your anti-fraud engine, we recommend informing them to expedite the process.

Integrate Clearsale

Start your integration with Clearsale by completing a certification with DEUNA in the test environment and then repeating the process in the production environment.

You will be able to use Clearsale in a centralized way in DEUNA.

1. Send an email to Clearsale to activate DEUNA

Send an email to Clearsale indicating that you will activate DEUNA, to activate Clearsale with pre-authorization

Enable DEUNA with Clearsale Pre-Authorization flow

Hello Clearsale team,

We will start the certification process with DEUNA with pre-authorization flow. Once we finish, cases will be sent for review for:
1. Automatic approval
2. Automatic rejection
3. Manual Analysis - Manually Approved
4. Manual Analysis - Manually Declined
5. Manual Analysis - Keep it in Analyzing state

In addition, we share DEUNA URLs to activate webhooks:
- Test environment: https://api.stg.deuna.io/manual-review
- Production environment: https://apigw.getduna.com/manual-review

Regards,

📘

Clearsale will indicate that they will enable the configuration in production, once test transaction evidence is sent.

2. Obtain test credentials

Access the Clearsale test portal with the information provided by Clearsale.

  1. In the dashboard, select the three dots and click on Settings.

  1. Copy the following data:
    • API Key
    • Client Id
    • Client secret

3. Configure DEUNA test environment

Activate Clearsale with Pre-Authorization in the staging test Admin.

  1. In the DEUNA Admin, go to Connections.
  2. Search for Clearsale and click on Connect.

  1. Enter the Clearsale credentials on the screen:
    • Enter test in Environment (test, live).
    • Enter your Clearsale Client secret in Client secret.
    • Enter your Clearsale id in Client Id.
    • Enter your Clearsale API key in API key.
  2. Click on Connect.

👍

Upon completing the configuration you will see a success message.

4. Test the integration

Perform the following integration tests:

#CaseRuleUse caseAcceptance criteria
1Automatic approvalDEUNA transaction with total amount ≤ 501. The buyer selects a product with an amount ≤ 50. 2. Selects DEUNA to make the payment. 3. Fills in the information and completes the purchase.1. The transaction is approved in DEUNA. 2. The transaction is approved in Clearsale. 3. The transaction is approved in your store.
2Automatic rejectionDEUNA transaction > 50 total amount ≤ 1001. The buyer selects a product with an amount > 50 and ≤ 100. 2. Selects DEUNA to make the payment. 3. Fills in the information and completes the purchase.1. The transaction in DEUNA is denied. 2. The transaction is denied in Clearsale. 3. The transaction is rejected in your store.
3Manual Analysis - Manually ApprovedDEUNA transaction for total amount > 1001. The buyer selects a product with an amount > 100. 2. Selects DEUNA to make the payment. 3. Fills in the information and completes the purchase. 4. The merchant enters their Clearsale and DEUNA panel to validate the pending transaction. 5. The merchant manually approves the transaction.1. The transaction in DEUNA is approved. 2. The transaction in Clearsale is approved. 3. The transaction in your store is approved.
4Manual Analysis - Manually DeclinedDEUNA transaction for total amount > 1001. The buyer selects a product with an amount > 100. 2. Selects DEUNA to make the payment. 3. Fills in the information and completes the purchase. 4. The merchant enters 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 in Clearsale is rejected. 3. The transaction in your store is rejected.
5Manual Analysis - Keep it in Analyzing stateDEUNA transaction for total amount > 1001. The buyer selects a product with an amount > 100. 2. Selects DEUNA to make the payment. 3. Fills in the information and completes the purchase.1. The transaction in Clearsale remains as analyzing.

Upon completing the tests you must enter DEUNA and search for the 5 transactions, in each one of them you must copy the transaction ID to send it to Clearsale. To do this you must enter the DEUNA dashboard and go to the orders module

When you enter the detail you must copy the transaction ID as in the image, for each of the tests performed

5. Send test evidence to Clearsale

Once the tests are completed, send an email to Clearsale with the transaction evidence. We recommend sending it in the same email where the DEUNA conversation was started.

Dear Clearsale team,

We attach evidence of tests with DEUNA in test environment:

1. Automatic approval:  1xxxxxxx123
2. Automatic rejection: 1xxxxxxx123
3. Manual Analysis - Manually Approved: 1xxxxxxx123
4. Manual Analysis - Manually Declined: 1xxxxxxx123
5. Manual Analysis - Keep it in Analyzing state: 1xxxxxxx123

We await your confirmation to perform activation in production.

Regards,

👍

Clearsale will respond indicating that you can proceed with the production process.

6. Repeat the process in production

Start the Clearsale and DEUNA certification process in the production environment.

For the production environment, the process is the same for obtaining Clearsale credentials and configuration in DEUNA Admin, but using production URLs and credentials:

  • Clearsale: https://app.clear.sale/
  • DEUNA: https://admin.deuna.com/

7. Perform production test transactions

Just like in the testing process you must send evidence to Clearsale.

📘

It is recommended to send evidence of at least three transactions to Clearsale once configured and activated.

🚧

You must have a card available to perform production tests.

8. Send production test evidence to Clearsale

To finish you must send the production transactions to Clearsale in the same email to validate that everything is correct.

9. Activate manual review in DEUNA

Once the fraud engine confirms that the webhook was activated, it is extremely important to perform the following configuration. You must enter your DEUNA configuration and go to Administration -> Commerce and activate the "General fraud settings" attributes

  • Enable manual review
  • Enable automatic execution of operations

Once activated, we can continue with the process.

👍

Clearsale is activated as anti-fraud engine.

Updated 15 days ago