Easy Integrator Index
OCX
cipwin32.ocx – The cipwin32.ocx file can be stored anywhere on the computer but it must be registered correctly for it to work. The ocx only needs to be registered once.
For specific registration instructions, see the section titled Registering cipwin32.ocx
DLL
cipeinet.dll – The cipeinet.dll and its support files must be stored in the parent application’s working folder, it does not require registration.
Properties & methods
| Field | Type | Required/ Default | Description |
|---|---|---|---|
| Clear | Routine | No | Clears all clears all the properties of all the classes except the CertificateFields, CommunicationFields and ConfigFields properties |
| LoadSetup | Routine | No | Loads the Communication Fields, Config Fields and Device settings that are configured by calling Setup |
| RequestSignature | Boolean | No | Activates an attached signature capture device to accept a customer’s signature without running a payment transaction. A status dialog screen displayed on the cashiers screen captured signature is returned in the ResultsFields.Signature property |
| Setup | Routine | No | Displays a screen that allows the user to configure the Communication Fields, Config Fields and Devices which is returned as a string. |
Easy Integrator transaction types
| ACH Transaction Types | Result | Description |
|---|---|---|
| Boolean ACHReturn | Returns True if Approved | (Gateway Only) Returns funds to customer via ACH wire transfer. |
| Boolean ACHSale | Returns True if Approved | (Gateway Only) Collects funds from customer via ACH wire transfer. |
Close batch types
| Boolean CloseBatch | Returns True on Success | Closes the current open batch. On success, returns results to the CloseBatch Results fields |
Credit transaction types
| Close Batch Type | Result | Description |
|---|---|---|
| Boolean GiftAddValue | Returns True if Approved | Adds funds to cards |
| Boolean GiftBalance | Returns True if Approved | Check current balance of card |
| Boolean GiftRedeem | Returns True if Approved | Deducts funds from card |
| Boolean GiftRedeemMax | Returns True if Approved | Checks Balance on card and deducts funds up to the balance from card |
Void transaction types
| Close Batch Type | Result | Description |
|---|---|---|
| Boolean GenericVoid | Returns True if Approved | Voids CreditSale, CreditReturn, CreditForce, GiftAddValue, GiftRedeem. Requires UniqueTransRef |
Easy Integrator classes
The Class EasyIntegrator contains one instance of the following classes:
CertificateFields
CloseBatchFields
CommunicationFields
ConfigFields
Customer
MultiTrans
ReportsFields
ResultsFields
TransFields
UtilitiesClose batch fields
| Property/ Method | Type | Description |
|---|---|---|
| Clear | Routine | Clears all CloseBatch properties |
| CreditCount | Integer | Number of credit transactions |
| CreditResultMessage | String | The text of the result as returned by the Gravity Payments Server |
| CreditSettled | Double | The actual credit settled amount |
| CreditSubmitted | Double | The credit amount as it was submitted by the Gravity Payments Server |
| DebitCount | Integer | Number of debit transactions |
| DebitResultMessage | String | Text message regarding debit settlement |
| DebitSettled | Double | The actual debit settled amount |
| DebitSubmitted | Double | The debit amount as it was submitted by the Gravity Payments Server |
| GiftCount | Integer | Number of gift transactions |
| GiftSettled | Double | In the future, this will return the actual gift settled amount |
| GiftSubmitted | Double | The gift amount as it was submitted by the Gravity Payments Server |
Config fields
| Property / Method | Type | Required / Default | Description |
|---|---|---|---|
| AllowModifyTip | Boolean | False (default) | Allows for the customer to enter tip values directly on the smart device |
| Clear | Routine | No | Clears all Config Properties |
| DisplayResultScreen | Boolean | No/ False | If set to true, a result confirmation dialog is displayed after each transaction |
| DisplayResultScreenOnError | Boolean | No/ False | If set to true, a result confirmation dialog is displayed ONLY after a failed transaction |
| PopupOnDebit | Boolean | No/ True | (Server Only)If set to true, a dialog is displayed on screen prompting for the PIN entry |
| ProcessAfterSwipe | Boolean | No/ True | This is relevant only when you use Secure Screens. If set to true, the transaction is automatically processed if the card is swiped into a secure screen |
| Processor | String | No/ Localhost | Controls whether processing with the Gravity Payments Desktop Server or Gravity Payments Gateway Cloud. Note: Canada option currently unavailable |
| ScreenNumber | Integer | No/ 1 | Only used in Secure Mode, If >0, the specified secure screen is displayed. It will contain the fields that are expected to be populated by the user |
| UseFees | Boolean | No/ False | (Server Only)This is relevant only to processing for government agencies and requires a special server license. If set to true, Fees are automatically calculated and presented in the Secure Screen for the user to see |
| UseLevel2 | Boolean | No/ False | This is relevant only when you use Secure Screens. If set to true, the Level2 field will be presented in the Secure Screen for the user to edit |
| UseTips | Boolean | No/ False | This is relevant to the Secure Screen and CreditAddTip transaction. If set to true, the tip field will be presented in the Secure Screen for CreditSale & CreditForce transactions. If set to false, CreditAddTip transactions are not allowed |
Customer fields (gateway only)
Displays dialog for the user to enter account information used for ACH payments. Account information is stored on the gateway and a new payment ID is returned. Requires a valid Customer Reference number.
| Property/ Method | Type | Required/ Default | Description |
|---|---|---|---|
| AddCheckPayment | Boolean | No | Displays dialog for user to enter account information used for ACH payments. Account information is stored on the gateway and a new payment ID is returned. Requires a valid Customer Reference number |
| AddCreditPayment | Boolean | No | Displays dialog for user to enter card data used for Credit payments. Card data is stored on the gateway and a new payment ID is returned.Requires a valid Customer Reference number |
| Clear | Routine | No | Clears all Customer and CustomerField properties |
| CustomerRef | String | No | Customer Reference number assigned when a new customer is added to the gateway. This value must be stored for use during customer transactons |
| DeleteCustomer | Boolean | No | Permanently removes a customer record from the gateway. Requires a valid Customer Reference number |
| DeletePayment | Boolean | No | Permanently removes a payment’s data from a customer’s record on the gateway. Requires a valid Customer Reference number and Payment ID |
| PaymentID | String | No | Payment ID assigned when a new payment is added to a customer record |
| UpdateCustomer | Boolean | No | Adds or Modifies a customer record on the gateway. Customer is added as new record if a blank customerreference is passed with this method call. Note: all CustomerFields must be populated when modifying an existing record or the fields will be blanked out |
| UpdateExpirationDate | Boolean | No | Displays dialog for user to enter a new credit card expiration date on an existing payment. Requires a valid Customer Reference number and Payment ID |
| UpdatePayments | Boolean | UpdatePayments | Adds or Modifies a customer record on the gateway. Customer is added as new record if a blank customer reference is passed with this method call. Displays dialog for user to manage customer payments. Management options can be restricted using SecurityFields. Note: all CustomerFields must be populated when modifying an existing record or the fields will be blanked out |
Customer fields
| Property / Method | Type | Required / Default | Description |
|---|---|---|---|
| Address | String | No | Customer record, street address |
| Address2 | String | No | Customer record, additional address information |
| City | String | No | Customer record,city |
| Company | String | Yes | Customer record, Company name Required if LastName field is blank |
| Country | String | No | Customer record, country of address |
| CustomerID | String | No | Customer record, can be used for alternate look up key |
| String | No | Customer record, email address. Note: future enhancement will allow transaction receipts to be emailed if this field is populated | |
| FirstName | String | No | Customer record, given name |
| LastName | String | Customer record, surname. Required if Company field is blank | |
| Phone | String | No | Customer record, contact phone number |
| State | String | No | Customer record, state of address |
| Zip | String | No | Customer record, Postal code of address |
Customer security fields
| Property / Method | Type | Required / Default | Description |
|---|---|---|---|
| Clear | Routine | No | Clears all Customer Security Field properties |
| PreventAddAccount | Boolean | No / False | Prevents user from selecting the Add button on the user dialog for Update Payments and Customer Transactions |
| PreventChangeExpDate | Boolean | No / False | Prevents user from selecting the Exp. Date button on the user dialog for Update Payments |
| PreventChangeName | Boolean | No / False | Prevents user from selecting the Name button on the user dialog for Update Payments |
| PreventDeleteAccount | Boolean | No / False | Prevents user from selecting the Delete button on the user dialog for Update Payments |
| PreventOneTimeTransaction | Boolean | No / False | Prevents user from selecting the Add Account button on the user dialog for Customer Transactions |
| PreventSetDefault | Boolean | No / False | Prevents user from selecting the Default button on the user dialog for Update Payments |
| PreventTestAVS | Boolean | No / False | Prevents user from selecting the Test AVS button on the user dialog for Update Payments. Also prevents AVS test using AddCreditPayment method |
| PreventUseChecks | Boolean | No / False | Prevents user from selecting the ACH Bank Transfers tab on the user dialog for Update Payments |
Form fields
| Property / Method | Type | Length* | Description |
|---|---|---|---|
|
formFields.Title
|
String | 32 per line | Displays a title above the buttons. |
|
formFields.Message
|
String | 36 per line | Displays a message for the user. This will read the last line, then slowly scroll the lines down. If the message cannot fit in one box, it will ask the user to continue before displaying the buttons in order to display the rest of the message. |
|
formFields.Button1Text
|
String | 24 | Displays text on button 1. A button can have two lines of text, both 12 characters long. |
|
formFields.Button2Text
|
String | 24 | Displays text on button 2. A button can have two lines of text, both 12 characters long. |
|
formFields.Button3Tex
|
String | 24 | Displays text on button 3. A button can have two lines of text, both 12 characters long. |
|
formFields.Button4Tex
|
String | 24 | Displays text on button 4. A button can have two lines of text, both 12 characters long. |
|
formFields.Result
|
Int | 2 | Returns the button that was pushed. If cancel was pushed, returns -1. |
|
ShowForm()
|
Method | N/a | Initiates forms on a device |
Report fields
| Property / Method | Type | Description |
|---|---|---|
| Clear | Routine | Clears all Report properties |
| DateTimeEnd | String | End period for reporting. Format:
YYYY-MM-DD HH:MM
Used with ReportOpenBatch & ReportTransactions methods |
| DateTimeStart | String | Start period for reporting. Format:
YYYY-MM-DD HH:MM
Used with ReportOpenBatch & ReportTransactions methods |
| ReportFileName | String | File name and path for saving report output. Report data is output in CSV format. Used with ReportOpenBatch & ReportTransactions methods |
Result fields
Lengths are an estimate based on real-world values. EasyIntegrator does not limit the field lengths and will return everything received from the processor. The length of data returned in a given field can vary by the processor and merchant account options.
| Property / Method | Type | Length* | Description | Examples |
|---|---|---|---|---|
| Clear | Routine | – | Clears all Results properties | N/A |
| AccountCardType | String | 2 | A 2-character code of the credit card type, such as VS, MC, or AX |
VS
|
| AccountEntryMethod | String | 32 | Indicates how the card was physically processed | Swiped |
| AccountExpiryDate | String | 4 | 4–character string formatted as MMYY: 0309, 1208, etc. |
0525
|
| AccountHash | String | 40 | Hash string of account number. This value can be safely stored on merchant systems and is used to match transaction history searches by account number when used with the Utilities Hash method.(
Deprecated
) |
Deprecated
|
| AmountBalance | Double | – | Balance of gift card after transaction. |
10
|
| AmountTipped | Bool | 10 | Returns whatever the tip amount was.Whether the tip is passed through TransFields or the device, it will show in ResultsFields |
10
|
| ApprovalNumberResult | String | 10 | ApprovalNumberResult |
093645
|
| AVSResponseCode | String | 1 | Single character code returned by the server when the card is keyed-in. Gravity Payments Server must be set to reply with AVS in Server Setup->License Configuration. |
Y
|
| AVSResponseText | String | 128 | Explanation of the AVSResponseCode | Match of Address and 5-Digit ZIP Code |
| BatchNumber | String | 32 | Processor identifier indicating which batch the transaction currently resides |
213934 – 1
|
| BillingName | String | 50 | Name of the card holder. Obtained internally by EasyIntegrator when a swiped card with Track 1 is provided in AccountData. May be used on the printed receipt to identify the cardholder. *Note: BillingName is not supported by all devices. |
JOHN Q PUBLIC
|
| CardNickname | String | Unlimited | Returns the Card Nickname field from the CreditSaveCard screen |
John Q’s Visa
|
| CVVResponseCode | String | 1 | Single character code returned by the server when the card is keyed-in. Gravity Payments Server must be set to reply with CVV in Server Setup->License Configuration. | 1 |
| CVVResponseText | String | 128 | Explanation of the CVVResponseCode | Not Processed |
| MaskedAccount | String | 20 | This is the account number masked according to the PA-DSS regulations where only the last 4 digits are revealed. Note: Masked digits will be displayed as asterisks. |
************9016
|
| ResultMessage | String | 128 | The text of the result returned by the Gravity Payments Server. | Example:
Invalid Card Number (3) [GW:13]
|
| ResultStatus | Boolean | – | True if transaction was approved. | True |
| Signature | String | 2000 | 3-byte ASCII format string. This format is used to minimize the length of the captured data image while using only printable ASCII characters. Returned from transactions using a signature capture device and used with SaveSignatureAsBMP and SaveSignatureAsJPG methods. |
Example:
MAIP:MU0yTDJNM0w0TDRLNEo0STVJNUg0SDRHM0cyRzNGMkYy RTFFMEUwRC9ELkMrRP//KkEsPys+KjwqOyg6KDkmNyU2JDQjMyIxITAgLx8tH iwdKx0qHCkcKBsoHCgdKB4oHyggKCEpIikjKSQqJSomKygsKSwqLisuLC8tMC8 xMDMxNDI2MjczOTQ6NTw1PjZBNkM3RTdIN0o2TTZPNVI1VDRXM1kzXDFfMW EwYy5mLWcnailsKW0nbiRvI28ibyFvIW4gbiBtH2wfayBqIGghZyJlImQiYiNhJF8lXiZ cJlsoWilYK1YtVC5TL1MxUjJQM080TjZON005TTpNO008TT1NP01ATUFMQU1C TENMRExFS0ZLR0tIS0hKR0pGSkVKREpDSkNLQktBS0FMQU1ATUBOP1A/UT9 SP1NAVEBVQVVBVkJWQ1ZEVkVVRlVGVEdUSFNJU0lSSlJKUUtRSlBKT0pOS05 LTUxMS0xMTEtMSkxJTEhMSE1ITEdMSExJTElNSE1HTUZORE///0k7SjtLO0s6TDp NO047TzxQPFA9UD5RP1FAUkJSQ1NEU0ZTSFRKVEtUTFROVE9UUVRSVFNTV FNVUlZTV1JYUllSWFJXUlZSVVNVU1RTU1RTVFJVUVVQVk9XTlhNWU1bTFxLXU peSl9JYElhSWJJY0pkSmVKZktnS2dMaExoTWhOaE9oUGdSZ1NnVGdVZlZmV2V XZVhkWGRZY1lkWWRYZVdlVmZVZlRnVGdTaFJpUWlQak9pT2hPaE5sTW1Nb01 wTXFNc011TnZPd1F3UnhTeFV4VnlYeVl5WnlbeVp5WXpYe1d8Vn1Wf1aBVYJVg1 WFVoZWh1aIVolXileMV4xYjViOWI9YkViPWI5YjViJWIRY//+HQI1B//+JQf//hUL//5FCm UGeQZ9AokD//6JAnUCoP6o/rT6uPbA8rjyuO7A7rzv//645//+sOLM2sja1NbY0tTS2 M7QztjK1MrQysjOyMrIzsTOvM600rDStNa41rzauN645rzqvPK49rECsQqxFrUirSqtN qlCrU6xUq1enWKdaoludXZ5dn16fXZVe//+WXZldmVyYXJdcllyUXJRblVqVWZlXm1ad VZxVnVWfVKFUo1OmU6dTqFOpU6xTrVOvU7BSsVO0UrVStlK6Ub1QvFC7UMFOw 07ETcVNxkzHTMhLykrLSsxJzUnNSM5Hz0fPRtBG0EXPRM1Ey0TKRMlEyEXHRcZG xUfER8RIw0nCSsFLv0y9TbFQuFG8Ub5Rv1G/UsBSwFHBUcNQx0/ITspNy03NTM5 M0UvTStVK1UnXSdlI2kfbR9tG20XcRN1E3UPeQt5B3UHeQd9B3kHfQd5B3kLfQt5C 30LeQ95E3UXbRt1H3kjeSd5K3UvbTNtO3E7cUNpR3FHdUt5T3lTgU+JS41LlUeNQ 40/nTulN6kzoS+tK7ErtSe5I7UjrSP//3DLbMtoz2jTYNNM2//8=
|
| TokenSaved | Boolean | – | Indicates whether a token was generated during the transaction. “True” means the UniqueTransID can be used to process additional transactions at a later time. | |
| TransactionType | String | 15 | Type of Transaction such as Credit Sale. | CreditSale |
| UniqueTransID | String | 40 | A unique reference returned by the Server on every transaction. Required in GenericVoid and AddTip transactions. | Example:
96f0158ceaf34f4296c5bf80c6a61635
|
| AID | String | 16 | Application Identifier-AIDs are used to identify the scheme and type of application(s) present on an ICC. Examples of schemes are “Common U.S. Debit” with an AID of A0000001524010 or “Visa Common Debit” with AID A0000000980840 | Example:
A0000000980840
|
| ARC | String | 2 | Authorization Response Code-The ARC is a two digit code generated by the issuer and sent to the CAD to approve, decline or refer a transaction. The most commonly used ARC consists of online approval (00), online decline (05) and referral (01). The CAD is prohibited to alter the ARC from the issuer. The CAD is allowed to generate an ARC in the following exception conditions: (see example) | Examples: Y1-Offline Approved Z1-Offline declined Y3-Unable to go online(offline approved) Z3-Unable to go online (offline declined) |
| AuthorizationMode | String | 32 | AuthorizationMode-Identifies the mode used to authorize (or decline) the transaction. This field must be identified by the label “Mode”. Issuer – The transaction sent online and approved or declined by the issuer. Card – The transaction was approved or declined by the card without going online. The transaction was stand-in approved by the merchant after being unable to go online. | Example: Issuer |
| CardHolderVerificationMethod | String | 25 | CVM identifies the Cardholder Verification Method (CVM) used for the transaction: If a PIN was entered “Verified by PIN” must be printed, If the CVM includes signature, a signature line must be printed, If NO CVM, a signature line should be printed for attended solutions. The Cardholder Verification must be printed on both the merchant and customer receipts. | Example: Signature, Verified by PIN or No CVM |
| CurrencyIndicator | String | 8 | Currency indicator | Example:
USD$
|
| EMVOfflineData | String | 1000 | EMV data for trouble-shooting purposes. | Example: Tag 50:Visa Credit or Debit Tag 5F2A: Tag 5F34:12 Tag 82:1234 Tag 95:0010008000 Tag 9A:140613 Tag 9C:125025 Tag 9F02:75.04 Tag 9F03:0.00 Tag 9F07:1234 Tag 9F0D:1234567890 Tag 9F0E:1234567890 Tag 9F0F:1234567890 Tag 9F10:06010A03A40002 Tag 9F12:VISA CREDIT Tag 9F1A:123 Tag 9F26:0123456789ABCDEF Tag 9F27:12 Tag 9F34:123456 Tag 9F36:1234 Tag 9F37:12345678 TAC Default:DC4000A800 TAC Denial:0010000000 TAC Online:DC4004F800 |
| IAD | String | 32 | Issuer Application Data-Contains proprietary application data that is required by the Issuer to be transmitted as part of the online authorization request. | Example:
IAD: A0000000031010
|
| TSI | String | 10 | Terminal Status Information-Identifies the functions performed by a CAD during transaction processing (e.g. offline data authentication, CVM, CRM, TRM etc.). | Example:
F800
|
| TVR | String | – | Terminal Verification Result-An EMV tag containing the status of several different EMV checks performed by the PIN Pad kernel or the EMV POS Solution. | Example:
0000008000
|
| Receipt | String | – | Pre-formatted receipt snippet that may be added to the bottom of a receipt. | CVM Signature Example: x___ JOHN Q PUBLICI AGREE TO PAY THE BELOW TOTAL AMOUNT ACCORDING TO CARD ISSUER AGREEMENT****9016 VS EntryMethod:Swiped Approval:187984 BatchNo.:192114 – 1 CreditSale AmountTotal:USD$128.00 Mode:Issuer AID:A0000000031010 TVR:0000008000 IAD:06010A03A400 TSI:F800 ARC:00 CVM:Signature Verified by PIN Example: Name:JOHN Q PUBLIC |
Trans fields
| Property / Method | Type | Required | Description |
|---|---|---|---|
| Clear | Routine | No | Clears all Trans Properties |
| ACHFormat | String | – | (Gateway Only) The file format that the ACH processor will use for a transaction. This is normally defined in setup when the merchant account is created |
| AmountTip | Double | No | This is the amount of the tip. Note that the AmountTip is included in the AmountTotal, which is the amount to be approved. The AmountTip is not added by EasyIntegrator to the AmountTotal |
| AmountTotal | Double | Yes | The amount to be approved. The AmountTotal field is a dynamic field and becomes a verification of the amount processed after a successful transaction. |
| ApprovalNumber | String | No | This is used on Force transactions only and is the ApprovalNumberResult field returned on the Authorization or the authorization number received when receiving an approval over the telephone |
| BillingStreetAddress | String | No | Billing street address
IE 123 Main Street
|
| BillingZip | String | No | Billing Zip or Postal Code |
| Cashier | String | No | Cashier or User reference |
| CashBack | Double | No | Amount of cash back. Only used in a debit transaction |
| Level2CustomerCode | String | No | Required for Level2. Customer code or reference |
| Level2OrderNumber | String | No | Required for Level 2.Typically a PO Number, but any order, invoice, sales order reference is acceptable |
| Level2Tax | Double | No | Required for Level 2. This is the amount of tax on the transaction |
| Note1 | String | No | Returned in output file.CIPCMD only [optional] |
| Note2 | String | No | Returned in output file.CIPCMD only[optional] |
| TransactionReference | String | No | Transaction reference such as Invoice, Receipt, or Customer Code |
| UniqueTransRef | String | No | This is the Gravity Payments universal token returned as UniqueTransID in a previous transaction. This token can represent the transaction for GenericVoid or AddTip transactions, or a specific card number to tokenized, card-on-file purposes |
Utilities
| Property / Method | Type | Description |
|---|---|---|
| Hash | Routine | Displays a user dialog where an account number can be entered manually or by swiping. The method returns a hash value of that account number for use in searching for matches to account hash values captured during transactions |
| SaveSignatureAsBMP | Boolean | Creates a Bitmap Image file from the signature string passed to this method. Used with the SignatureReduction method to control the size of the image file created |
| SaveSignatureAsJPG | Boolean | Creates a Jpeg Image file from the signature string passed to this method. Used with the SignatureReduction method to control the size of the image file created |
| ShowSignature | Routine | Passing this routine a previously saved signature string will display a user dialog showing the signature as a viewable image |
| SignatureReduction | Integer | Percentage to reduce the size of a signature image. Valid Values: 1~99, Default: 60. Used with the save signature as methods it allowed the image file to be sized to fit different print formats |
AVS Response codes
| AVSResponseCode | AVSResponseText |
|---|---|
| A | Address matches; ZIP Code does not match |
| E | Error response for Merchant Category Code – Visa only |
| N | Address and ZIP Code do not match |
| R | Retry, system not available. |
| S | Service not supported by issuer. |
| U | Address information is not available. |
| W | 9-Digit ZIP Code matches; address does not match – U.S. only. |
| X | Exact match of address and ZIP Code – U.S. only. |
| Y | Match of address and 5-Digit ZIP Code. |
| Z | 5-Digit ZIP Code matches; address does not match. |
| G | Non AVS participant outside U.S.; not verified. |
| B | Street Address matches for international transaction. Postal code not verified due to incompatible formats. (Acquirer sent both street address and postal code) |
| C | Street address and postal code not verified for international transactions due to incompatible formats. (Acquirer sent both street address and postal code) |
| D | Street address and postal code match for international transaction. |
| I | Address information is not verified on international transaction. |
| M | Street address and postal code match for international transaction. |
| P | Postal code matches for international transaction. Street address not verified due to incompatible formats. (Acquirer sent both street address and postal code) |
CVV Response codes
| CVVResponseCode | CVVResponseText |
|---|---|
| M | Card Verification Value matches |
| N | Card Verification Value does not match |
| P | Not processed |
| S | Card should have a Card Verification Value; Merchant indicated Card Verification Value is not present |
| U | Issuer not certified for feature |
AccountCardType codes
| AccountCardType | Card Name |
|---|---|
| AX | American Express |
| CU | China UnionPay |
| DC | Discover |
| DN | Diners |
| GC | Gift Card |
| JC | JCB |
| MC | MasterCard |
| VS | Visa |
| CP | Gravity Payments Test Card |
| XX | Other |
| CK | Check Guarantee or ACH Funds Transfer |
Errors
The Gravity Payments Desktop Server can return any of the following errors:
| Code | Description |
|---|---|
| 1 | Authentication Failed: Invalid IDs |
| 2 | Invalid Packet ID |
| 6 | Session Timeout |
| 9 | Send Error |
| 10 | Receive Error |
| 11 | Timeout Error |
| 12 | Invalid Request |
| 13 | Authentication Failed |
| 14 | Null Query |
| 30 | No Memory |
| 35 | Invalid Service Name |
| 40 | Service Unavailable |
| 41 | XML Error |
| 42 | HTTP Error |
| 43 | Internet Error |
| 44 | Incorrect URLs |
| 45 | No Service |
| 46 | XML Parser Error |
| 47 | Request Overflow |
| 48 | Incorrect Response |
| 49 | Packet Stopped |
| 50 | Other Error |
| 51 | Response Overflow |
| 52 | Internet Timeout |
| 53 | Send Error |
| 54 | Receive Error |
| 200 | Host Busy |
| 201 | Host Unavailable |
| 202 | Host Connect Error |
| 203 | Host Drop |
| 204 | Host Comm Error |
| 205 | No Response |
| 206 | Host Send Error |
| 405 | Vxn Timeout |
| 505 | Network Error |
| 987 | Transaction Interrupt |
| 989 | Unexpected Packet |
| 993 | Authentication Failed |
| 999 | Invalid Packet |
| C001 | Invalid Transaction Code |
| C002 | Invalid Account Number |
| C003 | Invalid Expiration Date |
| C004 | Transaction Amount Exceeds Maximum |
| C005 | Invalid Amount |
| C006 | Duplicate Transaction |
| C007 | Void Trans Not Found |
| C008 | Approval Code Required for Force Transactions |
| C009 | Invalid Sentinel in Swiped Data |
| C010 | Incomplete Track Data – Pls Swipe again |
| C011 | Previously Authorized Transaction |
| C012 | Decryption Error, Unable to Process Transaction |
| C013 | Debit Transactions May not be Voided |
| C014 | Invalid Void Request |
| C015 | Authorization Trans Not Found |
| C016 | Swipe Error. Track 2 Required. Please Retry |
| C017 | Offline Trans Not Found |
| C018 | AddTips Trans Not Found |
| C019 | Fee License Not Active or not defined as SSL |
| C020 | Credit Fee Percent Must to Be Greater than Zero |
| C021 | Minimum Fee Must Be Greater than Zero |
| C022 | No Fee License Defined |
| C023 | Invalid Fee Percent |
| C024 | Insufficient Fee |
| C025 | Fee Based License Data is Missing, Pls Correct |
| C026 | Debit Transaction Exceeded Maximum Allowed |
| C027 | Invalid Transaction Type for Fee Based License |
| C028 | Passphrase error, unable to process transaction |
| C029 | Original Trans Not Found |
| C030 | Invalid Transaction Type for Returns |
| C201 | Unable To Open Com Port |
| C202 | No Modem Detected |
| C203 | No Dial Tone |
| C204 | Line Busy |
| C205 | No Carrier |
| C206 | Server Busy Please Retry |
| C207 | Gift Server Unavailable |
| C301 | No ENQ |
| C302 | No ACK To Req After 30 Secs |
| C303 | No ACK NAK To Req |
| C304 | No ACK NAK After Resend |
| C305 | No ACK to Req |
| C306 | No Response After 30 Secs |
| C307 | Invalid LRC 3 Times |
| C308 | No Response After 5.5 Secs |
| C309 | No Final ENQ (EOT) Received |