You will make all Real-Time Loon requests to a single endpoint: /inquiry. If your request fails for authentication or network errors, you’ll receive an error in the format of the following example:

{
  "code": 403,
  "requestId": "8b764b09-5e2d-4562-8a74-6d04fbf574cd",
  "errorDetails": {
    "reason": "unauthorized",
    "message": "Merchant is not authorized to use the resource."
  }
}

API Error Details

HTTP Response CodeerrorDetails reasonerrorDetails messageRecommended Action
401AuthenticationFailedThe account updater service could not authenticate the request.Re-submit your request with correct credentials. Contact your Pagos account manager if the problem persists.
403unauthorizedMerchant is not authorized to use the resource.Re-submit your request with correct x-merchant-id in the header. Contact your Pagos account manager if the problem persists.
429concurrentLimitExceededYou exceeded the maximum allowed concurrent API calls.Keep concurrent API calls within the allowed concurrent API request limits.
500SystemErrorA system error occurred.Contact your Pagos account manager.
503NetworkErrorThe network cannot process the request.Re-submit your request later. Contact your Pagos account manager if the problem persists.

Validation Errors

If your request to Real-Time Loon fails due to a validation error (HTTP code 400), the response will include a code element that explains the source of the validation error.

The response will be in the format of the following example:

{
  error: {
    code: 'account_validation_month_invalid',
    message: "accountsEncrypted property validation's failed.",
    details: {}
  }
}

Validation Error Details

HTTP Response Codeerror codeRecommended Action
400validation_errorRe-submit your request following guidance in the details object.
400account_validation_account_number_invalidRe-submit your request with a valid PAN.
400account_validation_month_invalidRe-submit your request with a valid PAN expiry month.
400account_validation_year_invalidRe-submit your request with a valid PAN expiry year.

Pagos is currently working on normalizing the error message response body formats between API Error and Validation Error to aid in integraiton.