This guide walks you through entering your Clearent API details into CleanCloud for hosted and saved card payments, also known as Card Not Present (CNP) transactions.

Step 1: Obtain Your Clearent API Details

Clearent will provide your API details in a password-protected PDF. Once opened, ensure the document contains:

✔ Correct Business Name & Address – Especially important for multi-store businesses.
✔ Merchant Number – Verify it matches your store.
✔ Product Name – It should specifically mention "CleanCloud (CNP)" for Card Not Present transactions.

📑 The Clearent PDF will have a format similar to the image below:

Step 2: Enter API Keys into CleanCloud

Log in to CleanCloud.
Go to Settings → Admin → Payments & Finances → Payments → Clearent → Hosted Payments.
Copy and paste the API details from your Clearent PDF:
- API Key → Enter in the 'API Key' field.
- Public Key → Enter in the 'HPP Key' field.

📌 Note:

Ensure there are no extra spaces when copying the keys.
Double-check the details match exactly with your Clearent PDF.

Step 3: Save & Verify Changes

✔ Click Submit to save your changes.

🪄 Tip: If the page freezes on "Updating," refresh your browser and check the Payments section to confirm changes.

✔ To verify the setup, navigate to the New Order page, where a new payment option "Pay With Saved Card (Clearent)" should be available.

Step 4: Add Saved Card to a Customer Profile

Open the Customer CRM → Edit Customer tab.
Locate the 'Clearent Credit Card' field and add the customer's card details.
Once saved, a banner will appear on the New Order page, confirming a saved card is linked to the customer's account.