Idempotency errors

Idempotent requests can be tested within the Secure Test environment.

All Idempotency-related errors have a dedicated code value of 9, and are returned within the standard error message:

Copied!

<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE paymentService PUBLIC "-//WorldPay//DTD WorldPay PaymentService v1//EN"
 "http://dtd.WorldPay.com/paymentService_v1.dtd">
 <paymentService version="1.4" merchantCode="YOUR_MERCHANT_CODE"> 
   <reply>
     <orderStatus orderCode="YOUR_ORDER_CODE">
       <error code="9"> <!--This error code is specific to Idempotency-->
         <![CDATA[Error message]]>
       </error>
     </orderStatus>
   </reply>
 </paymentService>

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE paymentService PUBLIC "-//WorldPay//DTD WorldPay PaymentService v1//EN" "http://dtd.WorldPay.com/paymentService_v1.dtd"> <paymentService version="1.4" merchantCode="YOUR_MERCHANT_CODE"> <reply> <orderStatus orderCode="YOUR_ORDER_CODE"> <error code="9"> <!--This error code is specific to Idempotency--> <![CDATA[Error message]]> </error> </orderStatus> </reply> </paymentService>

Error code	Description	Meaning
9	Request in progress	A request with the same Idempotency Key is currently being processed.
9	Invalid idempotency-key	The Idempotency-Key header value is invalid.
9	Service not enabled	Idempotent requests are not enabled for this customer.

Search our documentation, API references and articles.

Idempotency errors

​