Docs Clarification: Loyalty / Payments Integration

I’ve got a point of confusion around the documentation for the Loyaly api.

Loyalty has an endpoint called ‘Redeem loyalty reward’. It’s docs say to use it only if you are not using the Orders API. In my case we are using the Orders api, but I do not see anything in the Orders Docs, or in the Payments Docs about using Loyalty points.

Can someone set me straight?

That’s correct! When you create the loyalty reward (, you can pass in an optional order_id. If you do pass an order id, then once it’s paid for it, it will automatically deduct the points from the loyalty account, so you do not need to call RedeemLoyaltyReward separately.