This endpoint allows users to place orders with Ascenda without explicit point redemption. This differs from the normal order, which requires Ascenda to process point redemption for fulfillment.
Error Codes
The table below lists error codes that apply to this specific endpoint. For other errors, please refer to our workflow advisory here on handling indeterminate errors with Ascenda.
| Error Code | Description |
|---|---|
| NN0001 | Indicates an unexpected error occured while processing the request. |
| NN1001 | Indicates invalid parameters. There are a few possible error messages: 1. recipient is required for gift card order 2. order_items multiple order items are not supported yet. 3. invalid order item type 4. order_item_type redemption is not enabled. 5. user_id is not a valid UUID 6. membership is missing 7. points_account_id is required when user has multiple points accounts 8. PointsAccount not found for id: xxxx |
| NN1002 | Indicates the resource not found. for instance, the loyalty program not found. |
| NN1011 | Reference ID already exists. |
| NN1301 | Member identifier is invalid determined by Ascenda's Validation Engine. |
(Workflow Advisory 1) Only one order item is supported at this time
Whilst the API supports multiple order_items to enable shopping cart-style flows, only one order_item is supported at this time.
(Workflow Advisory 2) Statuses to observe for order fulfillment outcomes
The status field showcases only the outcomes of the order fulfillment request. It doesn’t yet distinguish the final outcome of an order as we process points transfer fulfillments asynchronously.
You should observe for the status field of the points transfer order_items[].status field instead. When verifying whether the order item is successfully fulfilled, you should only observe for the fulfilled status as the only indicator of success. The cancelled or failed statuses indicates a failure scenario and you should refund the points back to the user.