Error Codes For Freedompay

Error Codes For Freedompay

NOTE: When coding an application, your logic should always be based off the FreeWay Decision Field, not the Error Code.

The list of Error Codes provided below is given to provide additional information about Declined, Failed, or Errored transactions.

FreeWay Error Codes

Code

Class

Description

Recommended Action

Other Notes

100

General

Approved

101

General

One or more required fields missing from the request

Consult the missingFields entry in the reply

102

General

One or more fields in the request contain invalid data

Consult the invalidFields entry in the reply

103

General

An invalid combination of services was requested

104

General

Duplicate transaction

111

EFV

One or more fields contains invalid data

112

EFV

One or more required fields missing

149

General

Issue occurred processing request; unknown error

Contact Freedompay immediately

150

General

Issue occurred processing request; application error

A fatal error occurred while processing the request. Do not retry the transaction; contact Freedompay immediately.

Code

Class

Description

Recommended Action

Other Notes

151

General

An internal timeout occurred while processing the request

Try again

152

General

An internal error occurred while communicating with the card processor

Contact Freedompay immediately

153

General

Unable to communicate with card processor

Try again

154

General

Invalid card processor configuration

Contact Freedompay immediately

161

General

Invalid Business Date / Business Date earlier than the most recent date

201

Payment

Call issuing bank for authorization

202

Payment

Expired card (or mismatched expiry date provided)

Obtain an updated card

203

Payment

Declined by issuing bank – unspecified reason

204

Payment

Insufficient funds

Some issuers return this for over-limit credit cards

205

Payment

Lost or stolen card

206

Payment

Stolen card

207

Payment

Issuing bank unavailable to authorize request

Code

Class

Description

Recommended Action

Other Notes

208

Payment

The card is not active or not eligible for this type of transaction

209

Payment

Incorrect PIN

Some issuers return this if the number of failed PIN attempts is exceeded

210

Payment

Card over limit

211

Payment

Incorrect card verification number (CVC/CVV2/CID)

212

Payment

Invalid PIN Data

213

Payment

Card not valid at this location

214

Payment

Invalid Track Data

220

Payment

Issuing bank rejected the transaction due to generic account problem

221

Payment

Suspected fraud

222

Payment

Account is frozen

229

Payment

Merchant Configuration error

Contact Freedompay immediately

231

Payment

Invalid account number

232

Payment

Card Type not enabled for merchant

Contact FreedomPay immediately

233

Payment

Processor rejected the transaction due to an issue with the request

Code

Class

Description

Recommended Action

Other Notes

234

Payment

Invalid merchant credentials

Contact FreedomPay immediately

235

Payment

Return amount exceeds the amount of original authorization

Currently applicable to stored value cards only

236

Payment

Processor reported an error while attempting to process the request

Try again

237

Payment

Processor reported an error while attempting to process the request

Contact FreedomPay immediately

238

Payment

The authorization has already been captured

239

Payment

The capture amount was for more than the authorization amount

Capture amount > Authorization amount is not necessarily an error. This is returned when it is.

241

Payment

Invalid Request ID

242

Payment

No un-captured authorization record was found

243

Payment

The transaction is already settled

245

Payment

The transaction contains both card data and an orderRequestID, but the card data does not match that from the original transcation

Code

Class

Description

Recommended Action

Other Notes

246

Payment

The transaction cannot be voided

247

Payment

The transaction has already been voided

248

Payment

The authorization for this transaction is no longer valid

250

Payment

A timeout occurred while waiting for a response from the processor

Try again

251

Payment

Processor or issuing bank does not support this transaction

252

Payment

The processor is not available

Try again

253

Payment

Merchant is not allowed to perform this transaction

261

eMSR Hardware

Track Data decryption error

Contact Freedompay immediately

262

eMSR Hardware

Device Not Supported

Contact Freedompay immediately

263

eMSR Hardware

Encryption Mode Not Supported

Contact Freedompay immediately

264

eMSR Hardware

Key set not registered

Contact Freedompay immediately

271

MicroFrame

Invalid or inactive moniker

281

Payment

Private Label account bankrupt

Code

Class

Description

Recommended Action

Other Notes

282

Payment

Private Label account closed

284

Payment

Private Label card is revoked

285

Payment

Private Label card is charged off

287

Payment

AVS/CVN Validation code not whitelisted

300

Promo / Terms

An error occurred in communicating with the Promotion Engine

Try again

301

Promo / Terms

The submitted transaction contains more than one promotion, but the remote system supports only one promotion code per transaction

302

Promo / Terms

The invoice would have zero value

310

Promo / Terms

Requested promotion(s) failed validation.

Check requirements for the promotion

311

Promo / Terms

The available window for this promotion has expired

312

Promo / Terms

This card is not eligible for this promotion

Check requirements for the promotion

313

Promo / Terms

This merchant is not eligible for this promotion

Check requirements for the promotion

Code

Class

Description

Recommended Action

Other Notes

314

Promo / Terms

The promotion is not valid at this time

Check requirements for the promotion

315

Promo / Terms

The scenario code specified for this promotion was not valid

Check requirements for the promotion

316

Promo / Terms

The merchant has not opted-in for the promotion

Check requirements for the promotion

317

Promo / Terms

The promotion engine found different available promotions than the one specified

Returned only for lookups

320

Promo / Terms

The merchant is not correctly configured for discounts (Program not found)

Indicates a configuration error in Freeway

322

Promo / Terms

This card is not eligible for any terms promotions

323

Promo / Terms

This merchant is not registered for this program

324

Promo / Terms

The entered promotion was not found

(Validates only)

330

Promo / Terms

The invoice did not satisfy the rules of the promotion requested

335

Promo / Terms

The qualifying subtotal is not within the purchase amount bounds of this promotion

Code

Class

Description

Recommended Action

Other Notes

336

Promo / Terms

The qualifying quantity is not within the amount bounds of this promotion

337

Promo / Terms

The eligible subtotal is not within the purchase amount bounds of this promotion

338

Promo / Terms

The qualifying subtotal is not within the percentage purchase amount bounds of this promotion

339

Promo / Terms

The invoice amount is not within the purchase amount bounds of this promotion

340

Promo / Terms

No products on the invoice qualify for the promotion requested

341

Promo / Terms

The product does not qualify for the promotion requested

342

Promo / Terms

The product does not qualify for the promotion requested

343

Promo / Terms

The product does not qualify for the promotion requested

344

Promo / Terms

The sale code did not apply for the promotion requested

Code

Class

Description

Recommended Action

Other Notes

345

Promo / Terms

The unit price submitted was either too high or too low for the promotion requested

346

Promo

The quantity submitted was either too high or too low for the promotion requested

347

Promo

The subtotal submitted was either too high or too low for the promotion requested

348

Promo

The non-qualifying items exceeded the threshold amount allowed by this promotion

401

Tokens

Error retrieving payment information from Token service

Try again later

Also used for mobile payments

402

Tokens

Expired token (mobile only)

408

Tokens

Disabled token (mobile only)

410

Tokens

Token over limit (mobile only)

431

Tokens

Invalid token

451

Tokens

Unsupported request

491

Tokens

Type of card backed by token does not

Code

Class

Description

Recommended Action

Other Notes

match the type of card sent to Freway

701

DCC

Successful retrieval of DCC Information Card is eligible

Ask if customer wants to use DCC rates

702

DCC

Card is not eligible for DCC

FCC Error Codes

These are error messages that are specific to the FCC and will generally be displayed in the event that the FCC is unable to communicate with FreeWay or if there is an issue between the FCC Server Service and the FCC Client Service. In some cases the error may be displayed if the transaction fails or is cancelled.

Code

Message

3000

Timeout Reversal

Indicates that a request was made to Freeway which timed out. A Timeout reversal request was sent to Freeway which voided the transaction. Not entered in the System Event Log.

3001

Freeway Connection Error (Timeout Reversal Failure)

Indicates that a request was made to Freeway which timed out. A Timeout Reversal Request was then sent to Freeway which also timed out. The most likely explanation for this error is some sort of network failure. It is likely, but not certain, that the original request never got to Freeway. Entered on the System Event Log.

3002

No Workstation ID Specified

FCC Server received a request from POS which requires a card-present transaction but there was no workstation id. Almost certainly due to a misconfiguration of the POS sytem. Entered on the System Event Log.

3003

Workstation ID Unknown

FCC Server received a request to be sent to a Workstation that which it does not know about. This implies that the POS system can communicate with the workstation but FCC Server cannot. It might possibly indicate an error in FCC Client. Its status and its logs should be examined. Entered on the System Event Log.

3004

Unsupported Opera Message

Opera-specific. FCC Server received an Opera Message (or message mode) that it does not support. FCC Server does not support most Opera Messages and some modes of those it does support. This either means that Opera has been misconfigured or that we have encountered a use case which was not anticipated. Entered on the System Event Log.

3005

MerchantReferenceCode, Transaction or Request ID Not Found

The MerchantReferenceCode, TransactionID or RequestID specified by the POS system was not found in the FCC Server database. This IDs are used to track follow on operations such as incremental authorizations and settlements. Failure to find the entry in the database might be due to a failed Database rollover or a misconfiguration of the POS sytem. More detailed information about the error can be found in the log. Entered on the System Event Log.

3006

Database Access Failure

FCC Server attempted to access its database and failed to do so. More detailed information about the error can be found in the log. This is likely a network or configuration error. It indicates a serious error if running in stand-alone mode. Entered on the System Event Log.

3007

Authorization Not Allowed

An Incremental Authorization was attempted on a card type which does not support it such as Debit.

3008

Internal Error

FCC Server encountered a state which was unexpected. It may indicate a bug in the operation of one of the system components (FCC Server, FCC Client or the POS System). More detailed information about the error can be found in the log. Entered on the System Event Log.

3009

FCC Client Comm Error

Applicable to Client/Server configurations of the FCC. Communication with the FCC Client was

lost, probably caused by a timeout but maybe something more severe. If a timeout happens during a request, the connection is closed automatically. If everything is actually in order, FCC Client will re-establish communication within ten seconds and everything will continue normally. More detailed information about the error can be found in the log. Entered on the System Event Log.

3010

Invalid POS Request

The POS system sent a request containing invalid data. Not entered on the System Event Log.

3011

POS Connection Lost

An attempt to send a POS Response failed because the connection was closed before FCC Server could respond, possibly due to network issues. More detailed information about the error can be found in the log. Entered on the System Event Log.

3012

Generic Error

3015

Multiple FCC Client Requests

A second request was made to invoke FCC Client before a previous one was complete. This is definitely due to a configuration error, possibly because more than one workstation has the same ID. Entered on the System Event Log.

3018

Cancel Failure

An attempt to service a Cancel request failed. Entered on the System Event Log.

3019

Request ID Not Found

The specified request ID was not found. Entered on the System Event log.

3020

Badly Formatted Request

The request is not valid. The error message gives more information about the problem.

3021

Offline Accept

A request was accepted offline.

3022

Offline Decline

A request was declined offline, likely because the amount specified is over the floor limit.

3024

Forced Offline

A request was processed as an offline transaction. This will usually be overwritted with a 3021 or 3022. If seen, a unhandled path has been triggered.

3026

Offline Processing Error

This error is return when the offline daemon refused to process a request because a previous request in the same transaction failed.

3027

Request Not Allowed Offline

This error is returned if the system is offline and the POS request cannot be performed in this mode.

3028

Signature Request

This error code is returned for a signature only request.

3029

Closed Client Connection

The client lost connectivity in the middle of a transactions. Can be caused by an abort request on another lane, or a restart of the client mid- transaction.

3030

Lane Timout

If the MSR device does not respond with card information within the timeout.

3102

MsrLib No Response

The device library did not return a valid response.

3120

No Device

No device attached.

3121

Device Error

The device encountered an error.

3122

Network Error

The library cannot connect to an IP device.

3123

Token Error

Encountered an error while attempting tokenize.

3124

EMV Application Blocked

The application selected on a chip card is not accepted by this merchant.

3125

Card Blocked

This card type is not supported by the merchant.

3126

Chip Decline

The host approved the transaction but the chip declined it.

3127

Bad Card

An issue with the card was encountered.

3128

Device Timeout

The device did not respond.

3129

Bad Request

Bad request sent to device.

3130

Driver Error

A problem was encountered from the driver.

3131

Offline

Operation not allowed in offline mode.

3132

Invalid PIN

The PIN entered is invalid.

3133

User Cancel

A user clicked the cancel button.

3134

Card Removed Prematurely

The user removed a chip card before the transaction was complete.

3135

Unknown Error

An unknown error occurred.

3136

Internal Error

An internal erorr occurred.

3137

Aborted

Result of an abort command. Graceful shutdown of client.

3138

Declined

A request was declined.

3139

Voice Auth

Voice Auth Required

3140

Not Supported

An invalid request: Token type not specified, Debit RFID, Device does not support sigcap

3141

Device Busy

Device is already processing a request.

Hosted Payment Page Error Codes

The HPP does not use standard error messages in the same way as either FreeWay or the FCC, it has its own simple set of Error Codes.

Error Code

Description

A

Accepted

B

B1 - B6 are BreadCrumb

C

Cancelled

D

Duplicate

E

Error Occurred

R

Card Rejected

    • Related Articles

    • Digital Dining Color Bar / error message meaning

      Yellow: Training Mode Magenta: Offline CC Orange: Stale License White: Mirror Configured but not working Cyan: Running Process Utilities Red: In Future Orders
    • Ipod POS.ini Settings

      [POS] TimerOrRegister=Register Register=HANDHELD Timer= POSDeviceType=HANDHELD CDVerify=BOTH ScalePort=None ScalePortSettings=9600,E,7,2 Pole Display=None FastScreen=PREP End of Day Reboot=YES PrepScreenDelay=5 NumberOfPrepDisplays=4 OPOS MSR=None ...
    • Token Guide

      Digital Dining Tokens Overview Tokens @{ACCOUNT_BALANCE} Layouts: Receipts, Checks Intended Use: Inserts the remaining balance when a customer charges the check to an A / R account. @{ACCOUNT_NAME} Layouts: Receipts Checks Digital Dining includes ...
    • Training Manuals

      Attached