025799 Add new ProcessReturn Call to Webservices

Khaos Control have made available a new ProcessReturn webservice call that will allow an external entity to process a return within Khaos Control.

 

A new ProcessReturn webservice call will be added that will allow an external entity to process a return within Khaos Control.

This new call will take in:

-              Return Code

-              Manual Auth Code

 

If the return code exists and has not been processed within Khaos Control the return and its credit note will be processed, and the refund will be marked as being manually processed with the provided auth code.

No PSP calls will be processed.

The webservice call should return the responses below, depending on the circumstances:

-              ERROR: Return does not exist or has been deleted.

-              ERROR: Return has already been processed.

-              ERROR: Return has been partially processed, unable to continue.

-              ERROR: Return Code or Auth Code not defined.

-              Return has successfully been processed.

 

CAVEAT:

-              Only 1 return can be processed per call.

-              No information pertaining to the return will be returned.

-              Returns must be new and not have been processed into a credit / exchange

 

An updated application will be provided with this functionality. The further configuration step(s) are as follows :

 

3.1 ‘ProcessReturn’ Webservice Call.

This defaults to the format :

 

     <urn:ProcessReturn>

        <ReturnCode xsi:type="xsd:string">xxxx</ReturnCode>

        <ManualAuthCode xsi:type="xsd:string">yyyy</ManualAuthCode>

     </urn:ProcessReturn>

 

Where :

xxxx is the ‘return code’ for the customer return in Khaos Control.

yyyy is the authorisation code stored in the RAUTH_CODE column of the LEDGER_PAYMENT  table of the Khaos Control database.

 

3.2 ‘ProcessReturn’ webservice return.

 

Example returns are :

<faultstring>Return does not exist or has been deleted.</faultstring>

<faultstring>Return Code or Auth Code not defined.</faultstring>

<faultstring>Return has already been processed</faultstring>

Note : If the return processing has been successful, then no message is returned.

                          

After applying the above Configuration, typical steps for usage would include:

 

4.1  When a customer return has already been created within Khaos Control, but it has not yet been processed.

4.2  When the webservice call is successful, the return will be processed in a similar way to when the ‘Process into Credit/Exchange’ button is pressed.



Did you find this article helpful?