Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Mage_Checkout

Module: Shopping Cart API

Resource: cart_coupon

Method:
  • cart_coupon.add (SOAP V1)
  • shoppingCartCouponAdd (SOAP V2)

Allows you to add a coupon code for a shopping cart (quote). The shopping cart must not be empty.

Arguments:

TypeNameDescription
stringsessionIdSession ID
intquoteIdShopping cart ID
stringcouponCodeCoupon code
stringstoreStore view ID or code (optional)

Return:

TypeDescription
booleanTrue if the coupon code is added

Faults:

Examples

Request Example SOAP V1
$proxy = new SoapClient('http://magentohost/api/soap/?wsdl');
$sessionId = $proxy->login('apiUser', 'apiKey');

$shoppingCartId = $proxy->call( $sessionId, 'cart.create', array( 'magento_store' ) );
$couponCode = "aCouponCode";
$resultCartCouponRemove = $proxy->call(
	$sessionId,
	"cart_coupon.add",
	array(
		$shoppingCartId,
		$couponCode
	)
);
Request Example SOAP V2
$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl'); // TODO : change url
$sessionId = $proxy->login('apiUser', 'apiKey'); // TODO : change login and pwd if necessary

$result = $proxy->shoppingCartCouponAdd($sessionId, '15', 'aCouponCode');
var_dump($result);
Request Example SOAP V2 (WS-I Compliance Mode)
$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl'); 

$sessionId = $proxy->login((object)array('username' => 'apiUser', 'apiKey' => 'apiKey')); 
 
$result = $proxy->shoppingCartCouponAdd((object)array('sessionId' => $sessionId->result, 'quoteId' => 15, 'couponCode' => 'aCouponCode', 'store' => '3'));   
var_dump($result->result);