Transaction Modify

The TransactionModifyRequest is a new request type in DAM v5.0 and is used to change the effective and/or expiration dates on a previously existing subscription sales transaction. For example, if a customer's subscription can't be renewed due to an expired credit card, the DAM Vendor may ask the DAM System to "nudge" the subscriber's cancellation date by one day to allow the renewal attempt to be made on the next day. This request type can also be used to set or modify the amount to credit against the original sale price of the subscription. Note that this will only be used if the transaction is already cancelled. See the TransactionCancelRequest.

Request / Response Examples

TransactionModifyRequest Example:

<?xml version="1.0"?>
<!DOCTYPE DAMRequest SYSTEM "http://haldms.halleonard.com/dam_dtd/DAMRequestVersion5.dtd">
<DAMRequest>
    <RequestHdr>
        <DAMVersion>5.0</DAMVersion>
        <VendorId>123</VendorId>
        <VendorKey>theKey123</VendorKey>
    </RequestHdr>
    <TransactionModifyRequest>
        <TransactionItem>
            <TransactionId>12345678</TransactionId>
            <EffectiveDate>2018-02-10 00:00:00</EffectiveDate>
            <ExpirationDate>2018-03-10 23:59:59</ExpirationDate>
            <CancelCredit>9.99</CancelCredit>
        </TransactionItem>
    </TransactionModifyRequest>
</DAMRequest>

TransactionModifyResponse Example:

<?xml version="1.0"?>
<!DOCTYPE DAMResponse SYSTEM "http://haldms.halleonard.com/dam_dtd/DAMResponseVersion5.dtd">
<DAMResponse>
    <ResponseHdr>
        <DAMVersion>5.0</DAMVersion>
        <VendorId>123</VendorId>
    </ResponseHdr>
    <TransactionModifyResponse>
        <TransactionItem>
            <TransactionId>12345678</TransactionId>
            <StatusCode>1</StatusCode>
            <StatusDescription>OK.</StatusDescription>
        </TransactionItem>
    </TransactionModifyResponse>
</DAMResponse>