• All Products

CStoreOffice® Support & Learning

Altria API Setup

With Altria API, you can receive your Altria promotions and pull them automatically into CStoreOffice® or Retail 360 Mobile for further processing.

Altria API is configured in your personal profile on the Petrosoft Customer Portal. The setup procedure is equally easy for both single and several stores and includes 3 simple steps described below.

For more information on how to process after they are automatically pulled, use the following help sections depending on the product you use:
- CStoreOffice®: Working with Promotions List.
- Retail 360 Mobile: Promotions.

Setting up Altria API through the Petrosoft AI assistant

The easiest way to set up integration with the Altria API is to use Petrosoft AI assistant. The chat bot will guide you through the entire setup process, removing the complexities associated with API integration:

  • Identify the current environment configuration.
  • Prompt you for essential details at each stage, such as your Altria Account Number.
  • Automatically set up the connection.

Setting up Altria API for a single store

To set up Altria API for a single store, follow the steps listed below:

ClosedStep 1: Create or log into your account at Petrosoft Customer Portal

To create or log into your account:

  1. Go to my.petrosoftinc.com.
  2. At the top right or bottom left of the portal's main page, click Sign In.

  3. In the Sign in to Petrosoft Cloud form:
  4. Enter the login and password from your Petrosoft account.
  5. Click Login.

If you have not registered in Petrosoft ecosystem yet, click Create An account, complete the account registration procedure and come back to this form for logging in.

ClosedStep 2: Purchase the Scan Data subscription

To purchase the Scan Data subscription at the Petrosoft Customer Portal:

  1. Go to the Home page of the Petrosoft Customer Portal.

  2. In the Requires your Attention section, go to Assign 1 Subscription.
  3. To the right of the Scan Data Subscription option, click Assign.

  4. In the Scan Data Subscription form:
  5. Select your store and click Continue.

  6. Select the company or vendor you are working with and click Done.

    Currently only Altria must be selected.

ClosedStep 3: Set up Altria API

Please note that before proceeding with the Altria API setup, you need to contact your Altria representative and sign the API consent form.

To proceed with the Altria API setup:

  1. Go to the Home page of the Petrosoft Customer Portal.
  2. In the Requires your Attention section, go to Setup 2 Subscriptions.
  3. Right to the Scan Data Subscription with the Altria vendor option, click Begin Setup.

  4. In the Scan Data for Altria form:
  5. Click Proceed to Set Up.

  6. In the Single Account section, enter the following data provided by Altria:
  • Account Number
  • Account Login
  • Account Password

    • Make sure the data provided from Altria is entered correctly into this form. Otherwise, promotions will not be pulled into your account.

  1. Click Submit.

  2. Click Done.

  3. Wait until promotions are pulled. It may take up to 30 minutes.
    Depending on the product you use, you can check pulled promotions in the following ways:
  1. Push promotions to the cash registers installed in your stores. Depending on the product you use, do either of the following:

Setting up Altria API for several stores

To set up Altria API for several stores, follow the steps listed below:

ClosedStep 1: Create or log into your account at Petrosoft Customer Portal

To create or log into your account:

  1. Go to my.petrosoftinc.com.
  2. At the top right or bottom left of the portal's main page, click Sign In.

  3. In the Sign in to Petrosoft Cloud form:
  4. Enter the login and password from your Petrosoft account.
  5. Click Login.

If you have not registered in Petrosoft ecosystem yet, click Create an Account, complete the account registration procedure and come back to this form for logging in.

ClosedStep 2: Purchase the Scan Data subscription

To purchase the Scan Data subscription at the Petrosoft Customer Portal:

  1. Go to the Home page of the Petrosoft Customer Portal.

  2. In the Requires your Attention section, go to Assign 1 Subscription.
  3. To the right of the Scan Data Subscription option, click Assign.

  4. In the Scan Data Subscription form:
  5. Select your stores and click Continue.

  6. Select the company or vendor you are working with and click Done.

    Currently only Altria must be selected.

ClosedStep 3: Set up Altria API

Please note that before proceeding with the Altria API setup, you need to contact your Altria representative and sign the API consent form.

To proceed with the Altria API setup:

  1. Go to the Home page of the Petrosoft Customer Portal.
  2. In the Requires your Attention section, go to Setup 2 Subscriptions.
  3. Right to the Scan Data Subscription with the Altria vendor option, click Begin Setup.

  4. In the Scan Data for Altria form:
  5. Click Proceed to Set Up.

  6. In the Single Account section, enter the following data provided by Altria:
  • Account Number
  • Account Login
  • Account Password

    • Make sure the data provided from Altria is entered correctly into this form. Otherwise, promotions will not be pulled into your account.

  1. Click Continue.

  2. Enter the RCN numbers into the corresponding fields and click Submit.

  3. Wait until the information provided is checked by the system.
    When the data is uploaded successfully, the green check marks are displayed for each store.

    ClosedYellow exclamation marks are displayed instead of green check marks

    In case the yellow exclamation marks are displayed after the data upload, it means that the data is not uploaded successfully.

    In this case you need to check your SFTP credentials and try again.

  4. Wait until promotions are pulled. It may take up to 30 minutes.
    Depending on the product you use, you can check pulled promotions in the following ways:
  1. Push promotions to the cash registers installed in your stores. Depending on the product you use, do either of the following:

Setting up Altria API for multiple accounts

To set up Altria API for multiple accounts, follow the steps listed below:

ClosedStep 1: Create or log into your account at Petrosoft Customer Portal

To create or log into your account:

  1. Go to my.petrosoftinc.com.
  2. At the top right or bottom left of the portal's main page, click Sign In.

  3. In the Sign in to Petrosoft Cloud form:
  4. Enter the login and password from your Petrosoft account.
  5. Click Login.

If you have not registered in Petrosoft ecosystem yet, click Create an Account, complete the account registration procedure and come back to this form for logging in.

ClosedStep 2: Purchase the Scan Data subscription

To purchase the Scan Data subscription at the Petrosoft Customer Portal:

  1. Go to the Home page of the Petrosoft Customer Portal.

  2. In the Requires your Attention section, go to Assign 1 Subscription.
  3. To the right of the Scan DataSubscription option, click Assign.

  4. In the Scan Data Subscription form:
  5. Select your stores and click Continue.

  6. Select the company or vendor you are working with and click Done.

    Currently only Altria must be selected.

ClosedStep 3: Set up Altria API

Please note that before proceeding with the Altria API setup, you need to contact your Altria representative and sign the API consent form.

To proceed with the Altria API setup:

  1. Go to the Home page of the Petrosoft Customer Portal.
  2. In the Requires your Attention section, go to Setup 2 Subscriptions.
  3. Right to the Scan Data Subscription with the Altria vendor option, click Begin Setup.

  4. In the Scan Data for Altria form:
  5. Click Proceed to Set Up.

  6. In the Multiple Account section, enter the Account Numbers provided by Altria.

    Make sure the data provided from Altria is entered correctly into this form. Otherwise, promotions will not be pulled into your account.

  1. Click Continue.

  2. Enter the following information provided by Altria:
  3. Select the Account Number from the drop down.
  4. Account Login
  5. Account Password

    6. You can select not all available stores and set them up later on.

  6. Wait until the information provided is checked by the system.
    When the data is uploaded successfully, the green check marks are displayed for each store.

    ClosedYellow exclamation marks are displayed instead of green check marks

    In case the yellow exclamation marks are displayed after the data upload, it means that the data is not uploaded successfully.

    In this case you need to check your SFTP credentials and try again.

  • Wait until promotions are pulled. It may take up to 30 minutes.
    Depending on the product you use, you can check pulled promotions in the following ways:
  1. Push promotions to the cash registers installed in your stores. Depending on the product you use, do either of the following:

Confidentiality level - Public use Last Updated: 2025-09-11 08:18:47.

Copyright Ⓒ 2002-2025 | Site Map | Portal | Privacy Policy | Terms and Conditions of Use | All Rights Reserved.
Petrosoft LLC | 290 Bilmar Drive, Pittsburgh, PA 15205 | Phone: 412-306-0640 | Fax: 412-202-5487

For more information, contact us.