# Quick Start Guide
source: https://developer.mastercard.com/donations/documentation/quick-start-guide/index.md

## Introduction {#introduction}

Mastercard Donate offers a suite of APIs that enable partner users and donors to engage with donation services in multiple ways. This flexible integration empowers consumers to support meaningful philanthropic cause, either directly or by linking their everyday spending to the charities they care about most.

This tutorial guides you through the process of onboarding and being able to consume the donations services on different environments.

## 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 Donation 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 **Mastercard Donate**.

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.

   <br />

6. Click **Proceed** to create your **Project Credentials** . Create a key alias and keystore password, note this.
   ![Sandbox Project](https://static.developer.mastercard.com/content/donations/uploads/create-sandbox-prj.png)

7. Download, and keep safe, your PKCS#12 (.p12) keystore file.

![Sandbox Project Keys](https://static.developer.mastercard.com/content/donations/uploads/sandbox-prj-keys.png)

8. Save your Sandbox credentials.
9. Proceed to generate your **Additional Credentials** (such as JWE encryption keys), this will be done automatically after you click **Create Project**.
10. Once you complete this flow you will land on the Project page.
11. From the Project page take note of your:   
    a. Sandbox and Production status ('Ready/Not Requested')  
    b. Sandbox and Production credentials: authentication consumer key and client encryption key fingerprint.
12. Email the **Consumer Key** to the Donate team using '[donate@mastercard.com](mailto:donate@mastercard.com)' for your sandbox onboarding.
13. The Donate Team will review and onboard the consumer by mapping your Consumer Key with the Mastercard sandbox test program. It takes 3 to 5 working days to complete the entire setup.
14. Once your sandbox onboarding process is completed, the Donate 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://developer.mastercard.com/platform/documentation/security-and-authentication/securing-sensitive-data-using-payload-encryption/#client-libraries).

### Testing the service {#testing-the-service}

You can test our service using three different methods:

1. **Using Postman** : If you are using Postman, please follow our [Postman Tutorial](https://developer.mastercard.com/platform/tutorial/use-postman-for-mastercard-apis/).
2. **Using Insomnia** : If you are using Insomnia, please follow our [Insomnia Tutorial](https://developer.mastercard.com/donations/tutorial/how-to-install-and-configure-insomnia-tool/index.md).
3. **Using our Reference Application** : If you are using our reference application, please go to our [Reference Application](https://developer.mastercard.com/donations/documentation/reference_app/index.md) page.  

For more information on testing, see our [Integration and Testing](https://developer.mastercard.com/donations/documentation/integration-and-testing/index.md) page.
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}

Once you complete successful Sandbox testing and want to be onboarded as a customer on MTF, you can [Contact us](mailto:donate@mastercard.com).

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:

1. Within your project, select 'Request Production Access'. ![Request Prod Access](https://static.developer.mastercard.com/content/donations/uploads/req-prod-access.png)
2. Provide your Production key alias and keystore password. ![Prod Key Cred](https://static.developer.mastercard.com/content/donations/uploads/prod-key-cred.png)
3. Save your key alias and keystore password for future reference.
4. Proceed to generate your **Additional Credentials** (such as JWE encryption keys).
5. Select **Update Project** . ![Addn Cred](https://static.developer.mastercard.com/content/donations/uploads/prod-add-cred.png)
6. Your production keys are generated and your project updated.
7. Download your production key files. ![Prod Keys](https://static.developer.mastercard.com/content/donations/uploads/down-prod-keys.png)
8. Email the **Production Consumer Key** to the Donate team using '[donate@mastercard.com](mailto:donate@mastercard.com)' for their approval.
9. Once the Donate team approves your production key, email a request to the Donate team at '[donate@mastercard.com](mailto:donate@mastercard.com)' for production onboarding with program and charity details. Share the program onboarding details to the Donate team when requesting for production onboarding.
10. The Donate Team reviews the request and simulates the onboarding process in the MTF using the sandbox consumer keys.
11. The Donate Team requests you via an email to test the integration in MTF using test charity details.
12. Once the integration and testing in MTF is successfully completed, you must inform the Donate team that the integration is working as expected.
13. Once you confirm successful testing in MTF, the Donate Team initiates the production onboarding steps using the production consumer key.
14. The Donate Team completes the setup and confirms back to the customer. It takes 3 to 5 working days to complete the entire setup.

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.

## Pricing {#pricing}

Contact your Mastercard representative to learn more about pricing. This table provides basic guidelines on pricing:

|                                                **TRY**                                                 |                                                           **BUILD**                                                           |                                            **LAUNCH**                                             |
|--------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
| *Free*                                                                                                 | *Services Fees*                                                                                                               | *Software and Maintenance Fees*                                                                   |
| Build and test using our core set of APIs in our sandbox environment and receive API support for free. | Engage with our Customer Technical Services Team (CTS) to build your solution and test in the Mastercard Test Facility (MTF). | Move to our production environment. Receive global support for your implementation in production. |