Setting Up ArcDynamic

Integration Specs:

Step-by-step guide

  1. API User Setup:
    1. Create an API user in the core application (Arc) : Users -> Add user
    2. Add a token for that newly created API user: Users -> Edit -> Security -> Add token
    3. Take note of the username/token and save in this URL

    4. https://REPLACE_WITH_DEPLOYMENT_CODE.skyrin.com/apps/cart/stores/REPLACE_WITH_STORE_CODE/services/cart/plugin.CartRover.handleWebhook/$/username=REPLACE_WITH_API_USERNAME/token=REPLACE_WITH_API_TOKEN/
  2. API Group Setup:
    1. Create an API group : Permissions -> API Groups -> Add group (e.g. Name=CartRover, Code=cartrover)
    2. Add the following API to the group : Permissions -> API Groups -> Edit -> APIs → cart: plugin.CartRover.handleWebhook (search for the plugin.CartRover portion, check the API, and click "OK" in the bottom right)
  3. User Group Setup:
    1. Create a user group : Permissions -> User Groups -> Add Group (e.g. Name=CartRover, Code=cartrover)
    2. Add the user created above to the user group : Permissions -> User Groups -> Edit -> Users -> Add user
    3. Add the API group created above to the user group : Permissions -> User Groups -> Edit -> API Group Permissions -> Add API Group
    4. Select "Write" in the Access Control Level

Finally, take the URL from above (if a new token was created, remember to replace it in the URL) and put it in CartRover field Webhook URL.

Verification

To verify, you can put the URL above in the browser and get a message like the following:
E05PRA1: Invalid event specified

Responses like:

{"id":null,"success":false,"data":false,"encoding":false,"code":401,"errorCode":"E01F1B1","message":"Authorization Failed","count":null,"errors":[]} 

indicate something is wrong with the permissions.


Note

It is recommended to clear your browser history and/or delete the token and create a new one after verifying everything is working.

General Integration Guidelines

Unable to render {include} The included page could not be found.