Introduction
This article provides step-by-step instructions for migrating from the legacy Cybersource NetSuite integration to the managed NetSuite SuiteApp (managed plug-in).
Prerequisites
- Business Center Account:
- You must have a Business Center account.
- If you do not have one, visit the Business Center Registration website to create an account.
- Follow the activation instructions sent by email and log in to complete the registration process.
- API Credentials:
- You will need your merchant key ID and shared secret key from the Business Center.
- For instructions, see your documentation on Creating a Shared Secret Key Pair.
- Store these credentials for use during integration.
Migration Steps
- Install the SuiteApp Integration:
- Log in to your Oracle NetSuite account.
- Click Customization.
- In the left panel, select SuiteBundler > Search & Install Bundles.
- In the KEYWORDS field, enter: Cybersource for Oracle NetSuite
- Click the bundle ID 316818.
- Click Install.
- Update the SuiteApp (If Already Installed):
- Navigate as above to Search & Install Bundles.
- Find the bundle ID 316818.
- Ensure the Replace Data option is selected for:
- API response code/message
- Processor Name
- Sec Code
- Click Update Bundle to start the update.
- To verify progress, return to the bundle list.
- Migrate from Legacy Profile to SuiteApp Profile:
- Install the SuiteApp as described above.
- Configure the new Payment Processing Profile and any required settings (see your documentation or user guide section on Configuring Payment Processing Profiles).
- Enable the new profile for existing payment methods and websites in the Payment Processing Profile form. Test the new profile in test mode.
- Switch to live mode once configuration is working as expected (uncheck the Test mode box).
- Search for any default Payment Processing Profile assigned on the customer master record. Remove the legacy profile and update to the new SuiteApp profile as needed.
- Remove the reference to the legacy profile from the website setup and assign the new SuiteApp profile.
- Clear the Authorization and Sale request types from the legacy profile to prevent new authorizations or sales.
- Ensure open transactions authorized by the legacy profile are handled appropriately.
- If a sales order (authorization) uses the legacy profile, but the cash sale uses the SuiteApp profile, the capture works if merchant ID and gateway match.
- Note: The capture payment event is visible in the cash sale record only.
- Once all legacy-authorized orders are processed, clear the Capture box and inactivate the legacy profile.
Note:
Refer to the SuiteApp bundle user guide for detailed information about fields and configuration. Test your workflows in the test environment before moving to production.
Refer to the SuiteApp bundle user guide for detailed information about fields and configuration. Test your workflows in the test environment before moving to production.