====== AddAdjustmentRequest ======

==== Overview ====

**AddAdjustmentRequest** allows you to add a onetime or recurring amount to any subscription.

**Learn More:**

  * [[:developer_guide:developer_guide#using-the-apis|Using the APIs]]  
  * [[:developer_guide:developer_guide#http-status-code|HTTP Status Codes]]  
  * [[:developer_guide:developer_guide#error-codes|Error Codes]] 
  * [[:developer_guide:developer_guide#troubleshooting|Troubleshooting]] 


===== AddAdjustmentRequest =====

==== XML ====

<code>

<?xml version="1.0" encoding="utf-8"?>
    <AddAdjustmentRequest>
        <Username>string</Username>	
        <Token>string</Token>
        <Guid>string</Guid>	
        <Adjustment>
             <Name>string</Name>
             <Description>string</Description>
             <Price>currency</Price>
             <TrialPrice>currency</TrialPrice>
        </Adjustment>		
    </AddAdjustmentRequest>

</code>



==== Elements ====


^ Name ^ Type ^ Occurrence  ^ Meaning ^
| **AddAdjustmentRequest** | container | required | Parent Element |
| Username | string | required | Merchant API Username (Not your Merchant Center login) |
| Token| string | required | Hash of API Username and Password. [[:developer_guide:developer_guide:LinkID|Creating a Token]] |
| Guid | string | always | This is the identifier for the subscription and should be referenced in future management requests |
| **Adjustment** | container | required | Parent Element |
| Adjustment/Name | string | required | Adjustment short name |
| Adjustment/Description | string | required | Adjustment memo |
| Adjustment/Price | currency | required | Adjustment Price |
| Adjustment/TrialPrice| currency | optional | Adjustment Trial Price |


===== AddAdjustmentResponse =====


==== XML ====

<code>

<?xml version="1.0" encoding="utf-8"?>
    <AddAdjustmentResponse>
        <Ack>string</Ack> 
	<Timestamp>timestamp</Timestamp>
        <Adjustment>
             <AdjustmentID>string</AdjustmentID>
        </Adjustment>
    </AddAdjustmentResponse>

</code>

==== Elements ====


^ Name ^ Type ^ Occurrence  ^ Meaning ^
| **AddAdjustmentResponse** | container | required | Parent Element |      
| Ack | string | always | Success, Error, or Warning |
| Timestamp | string | always | All responses return the official SB time stamp in UTC/GMT |
| **Adjustment** | container | always | Parent Element |
| Adjustment/AdjustmentID | string | always | Use the Adjustment ID to remove the adjustment later on |