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.
2. Get the App's ApiKey (x-api-key header).
3. Get credentials from the Loyalty team for the roles below.

2. Base URLs (CI-v2)

3. Example — create a bulk order

curl -X POST "https://rec-api.accorhotels.com/loyalty/v1/bulk-orders/bulk-order" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Authorization: Bearer <YOUR_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "employeesPmids": ["111111111", "222222222"],
    "administratorPmid": "999999999",
    "companyId": "C-0001",
    "companyName": "ACME Corp",
    "scCode": "SC-42",
    "productCode": "3086167",
    "subscriptionPlanCriteria": {
      "subscriptionCode": "ALL_ACCOR_BUSINESS",
      "action": "NEW",
      "plan": "standard"
    },
    "paymentChannel": "EMAIL"
  }'

The response contains the functional bulkOrderId and a redirectPayment link:

{
  "bulkOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "redirectPayment": "https://payment.accor.com/pay/3fa85f64"
}

4. Example — confirm the payment of a bulk order

Call this once the payment provider knows the outcome. bulkOrderId is the identifier returned by POST /bulk-order. paymentResult is one of PAID, FAILED or EXPIRED.

curl -X PATCH "https://rec-api.accorhotels.com/loyalty/v1/bulk-orders/bulk-order" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Authorization: Bearer <YOUR_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "bulkOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "paymentResult": "PAID"
  }'

PAID answers with status PAYMENT_DONE and starts card crediting in the background. FAILED and EXPIRED answer with status PAYMENT_FAILED and credit no card. The response does not include per-member results:

{
  "bulkOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "PAYMENT_DONE",
  "paymentResult": "PAID"
}

5. Example — read a bulk order

curl -X GET \
  "https://rec-api.accorhotels.com/loyalty/v1/bulk-orders/bulk-order/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Authorization: Bearer <YOUR_JWT>"

6. Troubleshooting