Get all defined bonus plan triggers

This GET operation retrieves all bonus plan triggers and returns them in a JSON payload.


GET /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_READ_PERMISSION


JSON response

In the JSON response, you receive a list of all bonus plan triggers.

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

200

success!

400

bad request

403

forbidden; user does not have appropriate privileges

404

bonus plan catalog not found

500

internal SPCM error

503

request rejected due to overload