ResponseCode Property
Indicates the status of the authorization request.
Syntax
fdmsgiftcard.getResponseCode([callback])
Default Value
""
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for the getResponseCode([callback]) method is defined as:
function(err, data){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'data' is the value returned by the method.
The callback for the setResponseCode([callback]) method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
Indicates the status of the authorization request.
This property will contain a two character response code indicating the status of the transaction request sent to the FDMS Closed Loop Gift Card system. The merchant must evaluate this response code and not the ResponseText or ResponseApprovalCode to determine the nature of a response message. A response code of "00" represents a successful transaction. All other response codes represent non-approved requests. All non-approved response codes should NOT be assumed to be "DECLINED" as an error condition may be present.
A list of valid result codes is:
Code | Description |
00 | Completed OK |
01 | Insufficient funds |
02 | Account closed. The account was closed, probably because the account balance was $0.00. |
03 | Unknown account. The account could not be located in the account table. |
04 | Inactive account. The account has not been activated by an approved location. |
05 | Expired card. The card's expiration date has been exceeded. |
06 | Invalid transaction code. This card or terminal is not permitted to perform this transaction, or the transaction code is invalid. |
07 | Invalid merchant. The merchant is not in the merchant database or the merchant is not permitted to use this particular card. |
08 | Already active. The card is already active and does not need to be reactivated. |
09 | System error. There is a problem with the cost processing system. Call your help desk or operations support. |
10 | Lost or stolen card. The replacement transaction could not be completed because the account was not previously marked as lost/stolen. |
11 | Not lost or stolen. The replacement transaction could not be completed because the account was not previously marked as lost/stolen. |
12 | Invalid transaction format. There is a transaction format problem. |
15 | Bad mag stripe. The mag stripe could not be parsed for account information. |
16 | Incorrect location. There was a problem with the merchant location. |
17 | Max balance exceeded. The transaction, if completed, would cause the account balance to be exceeded by the max_balance specified by configuration of this system. Some merchants set the max_balance to a value twice that of the max transaction amount. |
18 | Invalid amount. There was a problem with the amount property in the transaction format. |
19 | Invalid clerk. The clerk property was either missing when required or the content did not match a clerk in the merchant's system. |
20 | Invalid password. The user password is invalid. |
21 | Invalid new password. The new password does not meet the minimum security criteria. |
22 | Exceeded account reloads. The clerk/user/location was only permitted to reload a specified number of accounts. That number has been exceeded. Contact the help desk or operations support. |
23 | Password retry exceeded. The user account has been frozen because the user attempted to access the account and was denied. Seek manager's assistance. |
26 | Incorrect transaction version or format number for point of sale transactions. |
27 | Request not permitted by this account. |
28 | Request not permitted by this merchant location. |
29 | Bad replay date. |
30 | Bad checksum. The checksum provided is incorrect. |
31 | Balance not available (denial). Due to an internal First Data Closed Loop Gift Card issue, information from this account could not be retrieved. |
32 | Account has been locked. |
33 | No previous transaction. The void or reversal transaction could not be matched to a previous (original) transaction. In the case of a pre-authorization redemption, the corresponding locking transaction could not be identified. |
34 | Already reversed. |
35 | Generic denial. An error was produced which has no other corresponding response code for the provided version/format. |
36 | Bad authorization code. The authorization code test failed. |
37 | Too many transactions requested. |
38 | No transactions available/no more transactions available. There are no more transactions for this account or there are no transactions as determined by the specified first transaction number. |
39 | Transaction history not available. The history could not be provided. |
40 | New password required. |
41 | Invalid status change. The status change requested (e.g. lost/stolen, freeze active card) cannot be performed. |
42 | Void of activation after account activity. |
43 | No phone service. Attempted a calling card transaction on an account which is not configured for calling card activity. |
44 | Internet access disabled. This account may no longer use transactions in which an EAN is required. |
45 | Invalid EAN. The EAN is not correct for the provided account number. |
46 | Invalid merchant key. The merchant key block provided is invalid (e.g. The working key provided is an Assign Merchant Working Key transaction). |
47 | Internet Virtual and Physical cards do not match. When enabling a physical card to a virtual card, both must be from the same promotion. |
48 | Invalid transaction source. The provided source is not valid for this transaction. |
49 | Account already linked. This is the response received when enabling a physical card when the two provided accounts have already been linked. |
50 | Account not in inactive state. his is the response received when enabling a physical card when the physical card is not in an inactive state. |
51 | First Data Voice Services returns this response on Internet transactions where the interface input parameter is not valid. |
52 | First Data Voice Services returns this response on Internet transactions when they did not receive a response from Closed Loop Gift Card. |
53 | First Data Voice Services returns this response on Internet transactions where the client certificate is invalid. |
54 | Merchant not configured as International although the account requires it. The account allows currency conversions but the merchant is not configured for International. |
55 | Invalid currency. The provided currency is invalid. |
56 | Request not International. Merchant configured to require currency information for the financial transaction, however none was sent. |
57 | Currency conversion error. Internal Closed Loop Gift Card system error. |
58 | Invalid expression date. The expression date provided is not valid. |
59 | On void transaction, the terminal transaction number did not match. |
60 | First Data Voice Services error returned if Internet transactions check fails. |
67 | Target Embossed Card entered and transaction count entered do not match. |
68 | No account link. |
69 | Invalid timezone. |
70 | Account on hold. |
71 | Fraud count exceeded. |
72 | Location restricted. |
73 | Invalid BIN |
74 | Product code(s) restricted. |
75 | Bad post date. The date is not a valid date. |
This property is read-only.
Data Type
String