Utilisation du coupon
Il est possible de gérer manuellement l’utilisation des coupons via le tableau de bord,
mais cette API permet d’automatiser le processus lorsque les utilisateurs utilisent un coupon sur votre site web — pour une gestion plus efficace.
Cette API est disponible à partir du forfait Personnel.
Http Header
PUT /api/coupon/v1/redeem
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en
Request
{
"cpnNo": "ZJLF0399WQBEQZJM",
"userId": "x77hu",
"memo": "IP Address: 210.123.111.222, Request Page: example.com/shop/bags/p112233"
}| Domaines | Description des champs | Description | Exigée | Type |
|---|---|---|---|---|
| cpnNo | Coupon number | Numéro de coupon « utilisé » à traiter. Saisissez uniquement le numéro du coupon, sans le signe « - ». | string | |
| onsitePwd | On-site coupon usage password | Si un mot de passe a été défini pour l’utilisation en magasin, saisissez ce mot de passe. Si le mot de passe est incorrect, vous ne pourrez pas utiliser le coupon. | string | |
| userId | User ID | Permet de gérer qui a émis et qui a utilisé les coupons. Si la valeur du nombre maximum d’utilisations par personne est comprise entre 2 et 5, l’ID utilisateur doit être renseigné. En général, saisissez l’identifiant de connexion du membre inscrit sur votre site web. | string | |
| memo | Notes | Vous pouvez saisir des notes pour gérer l’utilisation des coupons. Indiquez l’adresse IP de l’utilisateur, la page et le service où le coupon a été utilisé, ainsi que toute autre information. Lorsque le nombre maximal d’utilisations par personne est illimité, vous ne savez pas qui a utilisé le coupon, donc vous pouvez gérer par nom d’utilisateur ou note. | string |
Response
{
"code": 0,
"message": "",
"result": null
}
| Domaines | Description | Type |
|---|---|---|
| code | Code de réponse (0:Succès) | int |
| message | Le message de réponse, ou un message connexe si le code de réponse est différent de zéro. | string |