# Parameters to Make a Guest Donation source: https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md ## Method to Make a Guest Donation {#method-to-make-a-guest-donation} | Method | Endpoint | |--------|-----------------------------------------------------------------------| | POST | ~~/donations/payments/guests~~ (deprecated) /donations/guest-payments | 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. ## Request parameters {#request-parameters} | Name | Type | Description | Notes | |-----------------------|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------| | **donation** | object | See [Donation](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#donation) attributes. | **Required** | | **user** | object | See [User](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#user) attributes. | **Required** | | **card** | object | See [Card](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#card) attributes. | **Required** | | **dedication** | object | See [Dedication](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#dedication) attributes | Optional | | **source** | string | defines request from Web or Widget | Optional | | **authPayerResponse** | object | See [Auth Payer Response](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#authpayerresponse) attributes | Optional | | **authentication** | object | See [Authentication](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#authentication) attributes | **Required** If authPayerResponse is used | | **3ds** | object | See [3DS](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#3ds) attributes | **Required** If authPayerResponse is used | | **3ds2** | object | See [3DS2](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#3ds2) attributes | **Required** If authPayerResponse is used , only for MPGS | ### Child Attributes {#child-attributes} #### donation {#donation} | Name | Type | Description | Notes | |------------------|--------|---------------------------------------------------------------------------------------------------------------------------|--------------| | **charityId** | string | The charity's unique identifier. Assigned by Mastercard at the time the charity is onboarded onto the Donations Platform. | **Required** | | **amount** | number | The amount of the donation selected by the donor | **Required** | | **donationType** | enum | The type of donation. Should be **DISASTER** for guest donations. | **Required** | #### user {#user} | Name | Type | Description | Notes | |---------------|--------|-----------------------------------------------|--------------| | **firstName** | string | Donor's first name. Also known as given name. | **Required** | | **lastName** | string | Donor's last name. Also known as family name. | Optional | | **email** | string | The email address of the donor. | **Required** | #### card {#card} | Name | Type | Description | Notes | |--------------------------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------| | **primaryAccountNumber** | string | The PAN of the payment card used for the donation. | **Required** | | **cvc** | string | The card verification code of the payment card selected for the donation. Optional for MPGS and Stripe payment gateways on Guest and One-Time payments. It is the three digits of the number printed on the signature strip on the reverse of the card. On American Express it is usually a four-digit code on the front. | **Conditional** | | **expiryInfo** | object | See [Expiry Info](https://developer.mastercard.com/donations/documentation/parameters/manage-onetime-guest-dn-param/guest/index.md#expiryinfo) attributes | **Required** | #### expiryInfo {#expiryinfo} | Name | Type | Description | Notes | |-----------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------| | **month** | integer | The expiration month of the associated card as an integer between 1 and 12. | **Required** | | **year** | integer | The four-digit year of the card's expiration date in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6). Minimum length: 7. Maximum length: 7. | **Required** | #### dedication {#dedication} | Name | Type | Description | Notes | |-------------------|--------|-------------------------------------------------|--------------| | **toAddress** | string | Email address to which email should send. | **Required** | | **recipientName** | string | Recipients last name. Also known as given name. | Optional | | **senderName** | string | The sender name. | **Required** | #### authpayerresponse {#authpayerresponse} | Name | Type | Description | Notes | |--------------------|--------|------------------------------------------|-------------------------------------------| | **authentication** | object | Contains details of 3DS and 3DS2 Objects | **Required** If authPayerResponse is used | #### authentication {#authentication} | Name | Type | Description | Notes | |----------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------| | **3ds** | object | Contains SCA details like acsEci, authenticationToken, transactionId. Note : 3ds has nothing to do with version of 3ds , it is format in which payment gateway accepts SCA fields. | **Required** | | **3ds2** | object | Contains SCA details like transactionStatus, protocolVersion. Note : 3ds has nothing to do with version of 3ds2 , it is format in which payment gateway accepts SCA fields. | **Required** | #### 3ds {#3ds} | Name | Type | Description | Notes | |-------------------------|----------------------------|----------------------------------------------------------------------------------------|---------------------------------------------| | **acsEci** | String | Value returned by Issuers indicating the outcome of authentication on 3DS transactions | Optional for MPGS , **Required** for Stripe | | **version** | String | Version returned by issuer to authenticate 3DS payments | **Required** only for Stripe | | **authenticationToken** | String | Value returned by Issuers to authenticate 3DS transactions | **Required** | | **transactionId** | String (valid UUID String) | A unique Identifier of each 3DS transaction | **Required** | #### 3ds2 - Required only for MPGS {#3ds2---required-only-for-mpgs} | Name | Type | Description | Notes | |-----------------------|--------|--------------------------------------------------------------------------------------------------------|--------------| | **transactionStatus** | String | Value retuned by issuer showing status of transaction. Permissible values -(Y,N) | **Required** | | **protocolVersion** | String | Version returned by issuer to authenticate 3DS payments. Permissible value - #.#.# where # is numeric. | Optional | ## Response Parameters {#response-parameters} | Name | Type | Description | |------------------------|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **transactionId** | string | The unique identifier of the transaction | | **transactionStatus** | string | The status returned for the transaction. **SUCCESS :** if transaction approved. **FAILURE :** if transaction declined. **PENDING :** if the transaction is pending with gateway or with user (SCA authentication). | | **transactionMessage** | string | The message returned for the transaction | | **reasonCode** | String | The failure reason code (**only in case of failed transaction**) | | **reasonMessage** | String | The message for the failure reason (**only in case of failed transaction**) |