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:
- aCuotaz credentials:
client_id
andsecret_token
- Access to Salesforce Commerce Cloud Business Manager
- Sandbox environment for testing
- Access to the aCuotaz plugin repository
- The
acuotaz_metadata_v1.zip
file (generated from themetadata
folder in the repo)
2. Install the aCuotaz Cartridge
- Clone or download the aCuotaz plugin repository.
- Compress the
metadata
folder into a file namedacuotaz_metadata_v1.zip
. - 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": "______" }
- Run the following command to upload the cartridge to your instance:
npm run uploadCartridge
3. Upload the Metadata
- In Business Manager, go to: Administration → Site Development → Site Import & Export
- Upload the generated
metadata.zip
file. - Import the ZIP and wait for the process to complete.
4. Configure aCuotaz Credentials
- Go to Merchant Tools → Site Preferences → Custom Preferences.
- Find the section aCuotaz Configuration.
- Enter your credentials:
- Client ID: provided by aCuotaz
- Secret Token: provided by aCuotaz
- Click Save to save the changes.
5. Verify the aCuotaz Installation
To ensure the aCuotaz cartridge is correctly installed, follow these steps:
- In Business Manager, go to Merchant Tools → Ordering → Payment Processors.
- In the Processor ID column, confirm that the following option exists:
ACUOTAZ_PM
- In Business Manager, go to Merchant Tools → Ordering → Payment Methods.
-
In the ID column, confirm that the following option exists:
ACUOTAZ_PM
-
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.
- Update the
dw.json
file with your production instance credentials (hostname, username, password, code version). -
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.