Located in: cart.class.php
Version Introduced: 3.8

Description: This template tag is used to display the coupon amount applied to the cart – You would most likely use this on the checkout page to print the discount total.

Note: This function just returns the value (with a currency sign) so to use this function you must use it with an echo to output the value to the browser. It must also be used within the cart loop.

[php] <?php while (wpsc_have_cart_items()) : wpsc_the_cart_item(); ?>[/php]

Code Example:
<tr class="total_price">
<td class=’wpsc_totals’>
<?php _e(‘Discount’, ‘wpsc’); ?>:
<td class=’wpsc_totals’>
<span id="coupons_amount" class="pricedisplay"><?php echo wpsc_coupon_amount(); ?></span>