POST /promotional_credits/deduct

This API call can be used to deduct promotional credits for a customer. Learn more about Promotional Credits.

For example, if a customer has a credit balance of $20, if you pass the amount as $5, then the customer's credit balance would become $15.

If you do not pass any amount as the input parameter then, it will deduct the whole available amount from the credit balance.

Servers

Name	Type	Required	Description
`chargebee-request-origin-device`	String	No	The device from which the customer has made the request
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/x-www-form-urlencoded"
`chargebee-event-webhook`	String	No	skip only webhooks Possible values: `"all-disabled"`
`chargebee-business-entity-id`	String	No	If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation.
`chargebee-event-actions`	String	No	skip all actions to be done on the events Possible values: `"all-disabled"`
`chargebee-request-origin-user`	String	No	The email address of your customer/user. Use this when the email address has only ASCII characters.
`chargebee-request-origin-ip`	String	No	The IP address of the customer where the request originated
`chargebee-request-origin-user-encoded`	String	No	The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header `chargebee-request-origin-user` is ignored.
`chargebee-event-email`	String	No	skip only emails Possible values: `"all-disabled"`

Name	Type	Required	Description
`customer_id`	String	Yes	Identifier of the customer.
`description`	String	Yes	Detailed description of this promotional credits.
`amount_in_decimal`	String	No	Amount in decimal.
`currency_code`	String	No	The currency code (ISO 4217 format) for promotional credit.
`amount`	Integer	No	Promotional credits amount.
`credit_type`	String	No	Type of promotional credits provided to customer. * general - General * referral_rewards - Referral * loyalty_credits - Loyalty Credits Possible values: `"general"` `"loyalty_credits"` `"referral_rewards"` Default value: "general"
`reference`	String	No	Describes why promotional credits were provided.

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.