Trigger bonus plan

This PUT operation configures a bonus plan to be added when specified base plan is purchased. You pass the information in the JSON payload and receive a 201 response code if successful.


PUT /pcc/spcm/bonusPlanTrigger


HEADER INFO

authorisation: HTTP Basic Auth

tenant: <tenantName>

content-type: application/JSON

accept: application/JSON

By default, accept is XML. You must explicitly set accept in your header to application/JSON to receive a JSON response.

permissions: SPCM_BONUS_PLAN_CREATE_PERMISSION


JSON payload

In the JSON payload, you need to add the following.

See the type descriptions for more details on each field.
{
    "basePlanDefinitionName":"AccumulatesOnPrecedence",
    "bonusPlanDefinitionName":"absoluteExpiry1",
    "validityPeriod":"2228days",
    "unitAmountPercentage":20,
    "renewal":true
}

Bonus plan trigger type descriptions

Field Type Description Mandatory

basePlanDefinitionName

String (max length 255)

Name of purchased Plan Definition.

Yes

bonusPlanDefinitionName

string (max length 255)

Name of bonus Plan Definition.

Yes

validityPeriod

string (max length 255)

Overrides the validity period in the Plan Definition.

No

unitAmount

long

Overrides the unit amount in the Plan Definition. Mutually exclusive with unitAmountPercentage.

No

unitAmountPercentage

integer

Percentage unit amount (the calculation using the original unit amount of the base plan. Mutually exclusive with "unitAmount").

No

renewal

boolean

Indicates if the bonus plan should be added on base plan renewal.

If the field is not set, uses the application property spcm.spm.subscriber.bonus.plan.on-renewal.enabled.

No


HTTP response codes

Code Description

201

success!

400

bad request

403

forbidden; user does not have appropriate privileges

404

bonus plan catalog not found

422

plan validation failed

500

internal SPCM error

503

request rejected due to overload