# Quick Start Guide
source: https://developer.mastercard.com/priceless-planet-carbon-tracker/documentation/quick-start-guide/index.md

## Introduction {#introduction}

Mastercard Carbon Calculator Experience (CCE) offers a suite of APIs that enable issuers to find out the carbon footprint of their cardholders based on their spending habits. Besides, it also empowers cardholders to help fund the restoration of millions of trees with the Priceless Planet Coalition reforestation initiatives.

This tutorial guides you through the process of onboarding and being able to consume the CCE services and data.

## Accessing the API on Mastercard Developers {#accessing-the-api-on-mastercard-developers}

1. Navigate to Mastercard Developers and click sign up to create an account.
2. Activate your account by opening the link sent to your email address, and log in.
3. Request access to the API if needed. APIs with a 'lock icon' require permission to view their documentation and create a project. To gain access to these services, you will need to submit an access request form. Once submitted, you will receive an email confirmation approving or denying your access.

## Generate credentials and create a Sandbox Project {#generate-credentials-and-create-a-sandbox-project}

To generate your Sandbox and Production credentials you must create a new Mastercard Developers project. Generating Sandbox credentials will give you access to our Sandbox, which has rich, mocked data, that will help you understand the API.

Follow these steps to create a Sandbox Carbon Calculator Experience Project:

1. Create a project on your [My Projects](https://developer.mastercard.com/dashboard/) page.
2. In the **Project Details** page, enter the name for your sandbox project.
3. Indicate whether you are creating a project on behalf of a client.
   1. Check **Yes** if you are creating an API integration project for a customer. For example, you could be an integrator, a processor, or a service provider and the customer could be a merchant, issuer, or acquirer.
   2. Provide the client company name and client company address (if applicable).
4. In the **Select your API service** field, select **Carbon Calculator Experience**.
5. Provide the commercial countries for the project. This field represents where your client is doing business.
Note: If you are creating a project on-behalf of a client, the Commercial countries represent where your client is doing business. ![Create Project](https://static.developer.mastercard.com/content/priceless-planet-carbon-tracker/uploads/create-prj.png)
6. Click **Proceed** to configure your project with additional details.
   1. Enter the **Customer ID (CID)** This is a unique identifier generated in the Customer Data Management (CDM) portal. The following are the steps to find your customer ID:
      1. To find your bank's **Customer ID (CID)** , log in to the [Mastercard Connect Portal](https://www.mastercardconnect.com/).
      2. From the top navigation bar, click on **My Items** to see all the applications linked to your account.
      3. Click on the application **My Company Manager** to open the application.
      4. To search for the **CID** , use the search box located at the top right hand. Enter the name of your bank (a minimum of three characters) and you will see the six-digit **CID** numbers attached to your bank name. For example, the bank name (999999). For any further assistance, contact the support team.
   2. Enter the (comma-separated) **Sandbox BIN Range**, you want to use for the Carbon Calculator Experience API. For example, "534403, 518145, 518152, 5403, 5424".
   3. Select the **Sandbox Country of origin \& Currency** from the dropdown list. **United States (USA) \| US Dollar (USD)** comes by default in the dropdown list, Issuer's country of origin and currency.
   4. Enter the **Sandbox Privacy Notice URL**. This is the URL of the Issuer's Privacy Notice page relevant to the Carbon Calculator Experience API.
   5. Enter the **Sandbox Terms \& Condition URL**. This is the URL of the Issuer's Terms \& Conditions page relevant to the Carbon Calculator Experience API.
   6. Enter the **Sandbox Opt-Out URL**. This is the URL of the issuer's opt-out screen (as mandated by compliance). On being redirected to the opt-out screen, the user can de-register from the Carbon Calculator Experience API.
   7. Select the **Sandbox Disable Donation** check box.
      * This feature allows issuers to toggle the Donate feature on or off during the onboarding process.
      * By default, the check box is clear, indicating that the Donate feature toggle is on.
      * Selecting the check box gives issuers the flexibility to use other features of the Carbon Calculator Experience API while having the option to turn off the Donate toggle if desired.

   ![Create Additional Details](https://static.developer.mastercard.com/content/priceless-planet-carbon-tracker/uploads/create_sandbox_project_image.png) Note: End-user Sandbox Opt-out URL, Sandbox Privacy Notice URL, Sandbox Terms \& Conditions URL, Sandbox Country of origin and Currency are mandatory as per the contract. Contact support for further queries at [carboncalculator@mastercard.com](mailto:carboncalculator@mastercard.com)
7. Click **Proceed** to create your **Project Credentials**. Create a key alias and keystore password, note this.
![Project Credentials](https://static.developer.mastercard.com/content/priceless-planet-carbon-tracker/uploads/prj-cred.png)
8. Download, and keep safe, your PKCS#12 (.p12) keystore file.
9. Save your Sandbox credentials.
10. Proceed to generate your **Additional Credentials** (such as Client encryption keys and Mastercard encryption keys), this will be done automatically after you click **Create Project**.
![Additional Credentials](https://static.developer.mastercard.com/content/priceless-planet-carbon-tracker/uploads/addn-cred.png)
11. Once you complete this flow you will land on the Project page.
12. From the Project page take note of your:
    1. Sandbox and Production status ('Ready/Not Requested')
    2. Sandbox and Production credentials: authentication consumer key and client encryption key fingerprint.
13. Once your onboarding process is completed, the Carbon Calculator Experience team will inform you via email and you will be able to make API calls in the sandbox environment.

## Integrate {#integrate}

### Generate your own API client {#generate-your-own-api-client}

1. Navigate to the API documentation page.
2. Download the API specification (OpenAPI or Swagger).
3. Generate and configure an API client for this API.
4. Configure your client using our [client libraries](https://stage.developer.mastercard.com/platform/documentation/security-and-authentication/securing-sensitive-data-using-payload-encryption/#client-libraries).

Note: For a detailed step-by-step guide, see [Generating and Configuring a Mastercard API Client](https://developer.mastercard.com/platform/documentation/generating-and-configuring-a-mastercard-api-client/).

After you have tested your implementation and have met the eligibility requirements, you can ask your Mastercard representative for access to the Production environment.

## Go-Live {#go-live}

After successfully testing in the sandbox environment, you are ready to move your project to production, which enables the generation of keys necessary to access the MTF and Production environments.

Follow these steps to move to production and for more details refer [request production access setup guidelines](https://developer.mastercard.com/priceless-planet-carbon-tracker/tutorial/production-access/index.md):

1. Within your project, select 'Request Production Access'.
2. Provide your Production key alias and keystore password.
3. Save your key alias and keystore password for future reference.
4. Proceed to generate your **Additional Credentials** (such as Mastercard Encryption keys and Client Encryption keys).
5. Select **Update Project**.
6. Your production keys are generated and your project updated.
7. Download your production key files.

Note: Production Credentials are generated instantaneously, but they still need to be approved for Production environment access before you can go live. Once your Production access request has been reviewed, you will receive a notification confirming your access has been approved or denied. When you move to the production environment transactions will be billed. Contact your Mastercard representative to learn more about pricing.