How to use this API

1. Get credentials

Contact the APIM team (EXCHANGESYSTEMS.API@accor.com) to:

1. Get an App created on the Developer Portal for your partner.
2. Get the App's ApiKey (x-api-key header).
3. Get a JWT (Bearer token, HS512) from the Loyalty team for the ROLE_SUBSCRIPTION_PLANS_READ / ROLE_SUBSCRIPTION_PLANS_WRITE roles.

Your partner code (ACCOR_PLUS, AMEX, …) will be configured by the APIM team as a custom attribute partnerCode on your App. You never send it yourself.

2. Base URLs (CI-v2)

The legacy CI-v1 proxy is still reachable on /loyalty/v1/subscription/plans (same backend, different gateway path).

3. Example — list active plans

curl -X GET "https://rec-api.accorhotels.com/loyalty/v1/subscription-plans/plans" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Authorization: Bearer <YOUR_JWT>"

The gateway automatically adds X-Partner-Code: <your-partner> before forwarding to the backend. Only plans for your partner are returned.

4. Example — create a plan

curl -X POST "https://rec-api.accorhotels.com/loyalty/v1/subscription-plans/plans" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Authorization: Bearer <YOUR_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "subscriptionCode": "AMERICAN_EXPRESS_INDIA",
    "plan": "Platinum",
    "action": "New",
    "active": true,
    "productCode": "3086167",
    "subscriptionAdvantages": {
      "statusNights": 30,
      "stayPlus": 3,
      "rewardPoints": 450
    }
  }'

5. Example — patch a plan

action and productCode are query parameters — both are part of the composite business key.

curl -X PATCH \
  "https://rec-api.accorhotels.com/loyalty/v1/subscription-plans/plans/AMERICAN_EXPRESS_INDIA/Platinum?action=New&productCode=3086167" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Authorization: Bearer <YOUR_JWT>" \
  -H "Content-Type: application/json" \
  -d '{"active": false}'

6. Troubleshooting