Status Codes and Error Messages

Document created by jordanbarhorst on May 10, 2016•Last modified by gjsissons on May 18, 2016
Version 3Show Document
  • Comment • 0
  • View in full screen mode

Return to the list of PayFac API examples

 

The HTTP Status Codes provide information about the success or failure or a transaction. In the case of a failure, an errorResponse message will contain additional information.

 

Resource Information

 

CodeDescription
200Update/Retrieval/Disable is successful
201Create call is successful
400

Invalid Request. For example:

  • requested legal entity/sub merchant doesn't exist
  • invalid field data (data is too long, required data is not sent)
  • extra fields found in request
  • attempt to create sub merchant for unapproved legal entity

The response message will contain more details

401Failed Authentication
500Internal error. Litle & Co. is investigating the issue. Please contact Litle Customer Support for additional information.
503Returns for a soft decline or if the background checking service is unavailable. For a soft decline, please verify the submitted information and retry. If the service was unavailable, the Retry-After header contains a suggested retry time.

 

 

Example: Error Response - Status Code 400

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <errorResponse>
          <transactionId>82820205828260878</transactionId>
          <errors>
               <error>Error in Request:Legal Entity [Entity Name] has not been approved</error>
          </errors>
     </errorResponse>

 

or

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <errorResponse>
          <errors>
               <error>Error of [may not be null] on [subMerchantCreateRequest.merchantCategoryCode]</error>
               <error>Error of [size must be between 1 and 50] on [subMerchantCreateRequest.merchantName]</error>
          </errors>
     </errorResponse>

 

 

Example: Error Response - Status Code 401

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <errorResponse>
          <errors>
               <error>You are not authorized to access this resource. Please check your credentials.</error>
          </errors>
     </errorResponse>

 

Example: Error Response - Status Code 500

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <errorResponse>
          <errors>
               <error>Internal Error. This error has already been escalated to Litle for resolution. 
               Please contact support with questions.</error>
          </errors>
     </errorResponse>

 

 

Return to the list of PayFac API examples

Attachments

    Outcomes