Set Player Nurturing and Killing

This feature allows you to set a player and a nurturing amount in the backend to apply nurturing to an individual player. Once the player reaches the specified nurturing amount, they will automaticall

Scope of Application: Individual control, allowing independent management of a single player to enable personalized intervention.

OMG server time zone: UTC+0. Integrators should be mindful of time zone calculations when processing data statistics.

Amounts granted to players through customer nurturing incentives are calculated separately and are not offset against overall win/loss. For example: if the total win/loss is 100 and the nurturing amount is 50 (with a nurturing win/loss of -50), the billing amount will be calculated as 150.

ControlSet

This API is provided by the OMG platform and is called by the integrator.

POST {OMG_BACKEND_URL}/api/v1/merchant/outer/patron/control/set?trace_id=your_trace_id

{OMG_BACKEND_URL} is the API configuration interface in the merchant backend where the domain for backend API calls can be obtained.

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"your_sign_string"

Please refer to the Signature Algorithm and Example page for details on the signature algorithm.

Body

Name	Type	Description
app_id	string	Use the merchant appid obtained from the backend. For multi-currency merchants, pass the corresponding sub-merchant appid.
uname	string	The players’ platform IDs, separated by commas.
amount	integer	The nurturing amount (for each player), with the unit based on the merchant’s currency type. Supported range: 0.01–1,000,000. When passing the parameter, the value must be multiplied by 10,000.
type	integer	14 — Nurturing 15 — Killing
patron_type	integer	Customer nurturing parameter. This parameter must be provided when type = 14. 0: Fast customer nurturing 1: Slow customer nurturing

If multiple users and multiple games are specified, control will be applied/canceled across multiple games for multiple users.

Integrator Request Parameter Example

{
    "app_id":"10013",
    "uname":"1001726,1003401,1003402,1001719,1001720,1001721",
    "amount":1000,
    "type":15,

}

OMG Platform Response Parameter Example

Success

{
    "code": 1,
    "msg": "success"
}

Failed

Response Example Parameter Descriptions

Name	Requied	Type	Description
code	Yes	integer	Status Code
msg	Yes	string	Message
is_open	Yes	integer	The customer support function switch is 0 for off and 1 for on
evaluation_period	Yes	integer	Determination period 1-daily, 2-weekly, 3-monthly, 4-lifetime, 5-time period
turnover_multiple	Yes	integer	Reach the set turnover multiple to close the promotion state
net_income	Yes	integer	Reach the set profit closing promotion state
effective_count	Yes	integer	Effective times
trigger_interval_rounds	Yes	integer	Trigger interval number
custom_time_start	Yes	integer	When the evaluation_period is 5, there is a value
custom_time_end	Yes	integer	End time: When evaluation_period is 5, there is a value

Error Code

For more error codes, please refer to the Special Error Code page description.