---
title: "Activate Group Reward"
method: POST
path: "/pws/pws_reward_current_group_create/"
tags: ["Cashback"]
---

# Activate Group Reward

`POST /pws/pws_reward_current_group_create/`

## Request

- Base URL: `https://api.uat.paymentology.com/ppws/api`
- URL: `https://api.uat.paymentology.com/ppws/api/pws/pws_reward_current_group_create/`
- Auth: none declared

This web service allow us to apply reward at group level

## Request body

- PwsApplyGroupRewardModel
  - `api_call_unique_identifier` string, required: Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required: Unique identifier for the client which Paymentology will provide at outset
  - `effective_date` string, required: Effective Date
  - `expiration_date` string, required: Expiration Date
  - `group_id` integer, required: group Id
  - `max_cycle_reward` number, required: Maximum reward amount that can be awarded per cycle; -1.00 mean 'Not Set'
  - `max_daily_reward` number, required: Maximum reward amount that can be awarded daily (calendar daily); -1.00 mean 'Not Set'
  - `max_txn_reward` number, required: Maximum reward amount that can be awarded per transaction; -1.00 mean 'Not Set'
  - `reward_id` integer, required: Reward Id
  - `reward_rate_fixed` number, required: <p>Fixed reward Rate in the account's Billing Currency.</br> Default:0.00</p>
  - `reward_rate_logic` string, required: <p>Relation between reward rates computed based on percentage and fixed amount.</br>The value can be one of them:</p><ul><li>SUM: Sum of them</li> <li> MIN: Minimum of two amounts</li> <li>MAX: Maximum of two amounts</li> <li>AVG: Average of two amounts</li></ul>
  - `reward_rate_perc` number, double, required: <p>Reward Rate in Percents of the transaction </br>Default:0.00</p>
  - `user_id` string: User Id of the Customer who triggered the API request.
  - `remarks` string: Remarks for API request

## Response `200`

Successful Response

- ApplyGroupRewardResponse
  - `header` ApplyGroupRewardHeader
    - `error_id` integer: error id
    - `error_desc` string: error message
  - `body` ApplyGroupRewardBody
    - `message` string: Response message

## Other responses

- `404`: Webservices does not exist
- `500`: Internal Server error

## Changes

- **2026-11-03** `73c2771493b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paymentology/apis/payapi-docs/changes/pws/pws_reward_current_group_create/post.md)

---

[API](https://skmtc.dev/paymentology/apis/payapi-docs.md) - [All operations](https://skmtc.dev/paymentology/apis/payapi-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/payapi-docs/revisions/73c2771493b1?raw)