CORE-4897: added some better error handling and some additional documentation for the callback endpoints