Définir les récompenses

Xsolla Developers

Définir les récompensesServer-sideAdmin

put/merchants/{merchant_id}/promotions/{promotion_id}/rewards

Définit les récompenses pour une promotion. Si la promotion est en lecture seule (read_only = true), vous ne pouvez pas mettre à jour les récompenses.

Remarque

Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation.

SecuritybasicAuth

Request

path Parameters

merchant_id required	integer ID de commerçant.
promotion_id required	integer ID de promotion.

Request Body schema: application/json

object

Définit la récompense pour l'achat des objets virtuels spécifiques.

Array of objects

Objets virtuels supplémentaires octroyés en bonus.

Array

id	integer
localized_name	string Nom du plan dans la langue par défaut (en), répète la valeur du paramètre name.en.
quantity	integer Nombre d'objets virtuels octroyés en bonus.
sku	string UGS de l'objet.

Array of objects

Remises pour l'achat des objets virtuels spécifiques.

Array

discount_percent	number <float> Pourcentage de remise.
localized_name	string Nom du plan dans la langue par défaut (en), répète la valeur du paramètre name.en.
max_amount	number <integer> Nombre maximal d'objets auxquels la promotion s'applique.
sku	string UGS de l'objet.

object

Définit la récompense pour l'achat d'un package de monnaie virtuelle.

bonus_amount	number <float> Récompense sous forme d'une quantité absolue de monnaie virtuelle.
bonus_percent	number <float> Récompense sous forme d'un pourcentage de la quantité de monnaie virtuelle dans le package.

object

Définit la récompense pour l'ensemble de la commande.

discount_percent

number <float>

Pourcentage de remise.

object

Définit la récompense pour l'abonnement.

trial_days

integer

Période d'essai en jours.

Responses

204

No content.

Request samples

application/json

{"item": {"bonus": [{"quantity": 2,
"sku": "1234"
}
],
"discount": [{"discount_percent": 5,
"max_amount": 10,
"sku": "1234"
}
]
},
"package": {"bonus_amount": 5,
"bonus_percent": 5
},
"purchase": {"discount_percent": 10
},
"subscription": {"trial_days": 30
}
}