# Parameters to Store External Donations
source: https://developer.mastercard.com/donations/documentation/parameters/records/index.md

### Store external donations {#store-external-donations}

The `/donations/records` endpoint allows user to store donations from external partners, merchants and other solutions that do not integrate with Mastercard Donation APIs for processing donations.

## Method to Store External Donations {#method-to-store-external-donations}

| Method |      Endpoint      |
|--------|--------------------|
| POST   | /donations/records |

## Request Parameters {#request-parameters}

Note: The Entire Request Body has to be encrypted! For more details, refer to the [How to Encrypt](https://developer.mastercard.com/donations/tutorial/how-to-access-sandbox-environment/mastercard-encryption-decryption-mechanism/index.md) section.

|        Name         |  Type  |                                                                              Description                                                                               |    Notes     |
|---------------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------|
| **partner**         | object | An object representing the partner details. See [Partner](https://developer.mastercard.com/donations/documentation/parameters/records/index.md#partner) attributes.    | **Required** |
| **customer**        | object | An object representing the customer details. See [Customer](https://developer.mastercard.com/donations/documentation/parameters/records/index.md#customer) attributes. | Optional     |
| **merchant**        | object | An object representing the merchant details. See [Merchant](https://developer.mastercard.com/donations/documentation/parameters/records/index.md#merchant) attributes. | Optional     |
| **transactionDate** | string | The date and time associated with the transaction. Must be in `yyyy-MM-dd HH:mm:ss` format.                                                                            | **Required** |
| **transactionId**   | string | The transaction's unique identifier.                                                                                                                                   | **Required** |
| **campaignId**      | string | The campaign's unique identifier                                                                                                                                       | Optional     |
| **currency**        | string | The currency name.                                                                                                                                                     | **Required** |
| **amount**          | string | The donation amount.                                                                                                                                                   | **Required** |
| **cardScheme**      | string | Card Scheme Name.                                                                                                                                                      | Optional     |
| **charityId**       | string | The charity's unique identifier.                                                                                                                                       | Optional     |
| **charityName**     | string | The charity's name.                                                                                                                                                    | **Required** |
| **donationType**    | string | The type of donation.                                                                                                                                                  | Optional     |

### Child Attributes {#child-attributes}

#### partner {#partner}

|        Name        |  Type  |                                                       Description                                                       |     Notes     |
|--------------------|--------|-------------------------------------------------------------------------------------------------------------------------|---------------|
| **partnerName**    | string | The Partner's name.                                                                                                     | **Required**  |
| **isoCountryCode** | string | The addresses country in three-character [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format. | **Required**. |
| **locale**         | string | The Partner's preferred locale (languages).                                                                             | Optional      |

#### customer {#customer}

|        Name        |  Type  |                                                       Description                                                       |     Notes     |
|--------------------|--------|-------------------------------------------------------------------------------------------------------------------------|---------------|
| **customerName**   | string | The Customer's name.                                                                                                    | **Required**  |
| **isoCountryCode** | string | The addresses country in three-character [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format. | **Required**. |
| **locale**         | string | The Customer's preferred locale (languages).                                                                            | Optional      |

#### merchant {#merchant}

|       Name       |  Type  |            Description            |  Notes   |
|------------------|--------|-----------------------------------|----------|
| **merchantId**   | string | The Merchant's unique identifier. | Optional |
| **merchantName** | string | The Merchant's name.              | Optional |

## Response Message {#response-message}

A successful request returns the `HTTP 200 (Success)` status code.