Salesforce Integration Guide – aCuotaz

This guide will help you integrate aCuotaz as a payment method in your Salesforce Commerce Cloud (SFCC) storefront.


1. Prerequisites

Before starting, make sure you have:


2. Install the aCuotaz Cartridge

  1. Clone or download the aCuotaz plugin repository.
  2. Compress the metadata folder into a file named acuotaz_metadata_v1.zip.
  3. Open the dw.json file at the root of the project and replace its values with your own credentials.
    {
        "hostname": "______.commercecloud.salesforce.com",
        "username": "______",
        "password": "______",
        "code-version": "______"
    }
  4. Run the following command to upload the cartridge to your instance:
    npm run uploadCartridge

3. Upload the Metadata

  1. In Business Manager, go to: Administration → Site Development → Site Import & Export
  2. Upload the generated metadata.zip file.
  3. Import the ZIP and wait for the process to complete.

Import Screenshot


4. Configure aCuotaz Credentials

  1. Go to Merchant Tools → Site Preferences → Custom Preferences.
  2. Find the section aCuotaz Configuration.
  3. Enter your credentials:
  4. Client ID: provided by aCuotaz
  5. Secret Token: provided by aCuotaz
  6. Click Save to save the changes.

Credentials Screenshot


5. Verify the aCuotaz Installation

To ensure the aCuotaz cartridge is correctly installed, follow these steps:

  1. In Business Manager, go to Merchant Tools → Ordering → Payment Processors.
  2. In the Processor ID column, confirm that the following option exists: ACUOTAZ_PM

Payment Processor Screenshot

  1. In Business Manager, go to Merchant Tools → Ordering → Payment Methods.
  2. In the ID column, confirm that the following option exists: ACUOTAZ_PM

  3. Ensure it is Enabled.

✅ No further configuration is required at this stage.


6. Testing

To test the integration, follow the instructions in our Testing Guide.

Make sure to verify:

☐ The aCuotaz button appears at checkout

☐ The redirect and financing flow works correctly

☐ The order status is updated automatically


7. Go Live

Once everything works in sandbox, repeat the same setup in your production environment, as SFCC does not support automatic promotion.

  1. Update the dw.json file with your production instance credentials (hostname, username, password, code version).
  2. Repeat steps 2–5 exactly as before:

    • Upload the cartridge
    • Import metadata.zip
    • Configure production credentials in Custom Preferences
    • Verify that ACUOTAZ_PM is enabled in Payment Processors and Payment Methods

Your store is now ready to offer aCuotaz as a payment option in production.