Automattic\WooCommerce\Internal\RestApi\Routes\V4\Orders

UpdateUtils::prepare_coupon_data │ protected │ WC 1.0

Create or update an order coupon.

Method of the class: UpdateUtils{}

No Hooks.

Returns

WC_Order_Item_Coupon.

Usage

// protected - for code of main (parent) or child class
$result = $this->prepare_coupon_data( $request_data, $action, $item );

$request_data(array) (required)

Item data.

$action(string)

'create' to add coupon or 'update' to update it.
Default: 'create'

$item(object)

Passed when updating an item. Null during creation.
Default: null

UpdateUtils::prepare_coupon_data() UpdateUtils::prepare coupon data code ^{WC 10.4.3}

protected function prepare_coupon_data( $request_data, $action = 'create', $item = null ) {
	$item = is_null( $item ) ? new WC_Order_Item_Coupon( ! empty( $request_data['id'] ) ? $request_data['id'] : '' ) : $item;

	if ( 'create' === $action ) {
		$coupon_code = ArrayUtil::get_value_or_default( $request_data, 'code' );
		if ( StringUtil::is_null_or_whitespace( $coupon_code ) ) {
			throw new WC_REST_Exception( 'woocommerce_rest_invalid_coupon_coupon', esc_html__( 'Coupon code is required.', 'woocommerce' ), 400 );
		}
	}

	$this->maybe_set_item_props( $item, array( 'code', 'discount' ), $request_data );
	$this->maybe_set_item_meta_data( $item, $request_data );

	return $item;
}