VAS/Promotion errors

These errors happen when something's wrong with the applying promotions feature. Below you can find the most common situations and their respective solutions.

Advert is not ready to apply the VAS

The advert is still been processed, and it is in transient status or was not successfully published. So, due to that, the advert is not ready to apply for a promotion.

In this case, your application will receive a notification like the one below:

{
    "transaction_id": "3f775351-211b-463a-bff8-0c833e52dc85",
    "message": "This advert is not ready to apply the VAS."
}

Solution

Wait for the notification indicating that the publish request was completed with success, as notification type advert_posted_success. After that, you can submit the request to apply for a promotion.

VAS/Promotion error

You received a vas_promotion_error notification, with an explanation that you try to apply a promotion that doesn't exist for the RE Marketplace target or is not available for the advert. That means:

1. the promotion type and/or duration doesn't exist on the RE Marketplace, or;
2. the promotion is not available for the advert.

{
  "destination": "https://webhook.site/4c012083-60c3-49b0-bc28-e4d0133cea0b",
  "timestamp": 1622472112621,
  "event_timestamp": 1622472112621,
  "transaction_id": "dde1aa8b-fe81-48f8-b192-42b9e5aaf534",
  "object_id": "3317144b-a061-4848-9c87-bb0c50cbb354",
  "flow": "vas",
  "error_message": "VAS with promotion_code: top and duration 1 not available for ad 3317144b-a061-4848-9c87-bb0c50cbb354",
  "data": {
    "detail": "VAS with promotion_code: top and duration 1 not available for ad 3317144b-a061-4848-9c87-bb0c50cbb354",
    "title": "Error applying promotion",
    "validation": null
  },
  "event_type": "vas_promotion_error"
}

Solution

First of all, make sure you apply an existing combination (promotion type and duration), on the RE Marketplace. Check here how can you see all available combinations.
Secondly, if you are receiving this error and you apply an available combination for the marketplace, that means that the promotion was already being applied to the advert. So, in this case, display a message to the client informing him that you are not able to confirm if the VAS was or not successfully applied, so he can check his RE Marketplace account.