My Profile_


Standard Response Fields

To collect the applicable response details, once you send the transaction by invoking the HttpsPostRequest object's send() method you may instantiate the Receipt object, by invoking the HttpsPostRequest object's getReceipt() method. Use this object to retrieve the applicable response details.

This section outlines all of the possible response fields that may be returned. For response details custom to a particular transaction please refer to that transaction example.

Standard Response Fields

HttpsPostRequest mpgReq = new HttpsPostRequest();
Receipt receipt = mpgReq.getReceipt();


Transaction Response Fields

VALUE LIMITS GET METHOD DESCRIPTION
Order ID / Receipt ID 50 – character alphanumeric receipt.getReceiptId(); Returns the order_id from the request.
Reference Number 18 – character alphanumeric receipt.getReferenceNum(); Terminal used to process the transaction as well as the shift, batch and sequence number. This data is typically used to reference transactions on the host systems, and must be displayed on any receipt presented to the customer. This information is to be stored by the merchant. Example: 660123450010690030
  • 66012345: Terminal ID
  • 001: Shift number
  • 069: Batch number
  • 003: Transaction number within the batch.
Response Code 3 – character numeric Or null receipt.getResponseCode(); Transaction Response Code < 50: Transaction approved >= 50: Transaction declined NULL: Transaction was not sent for authorization For further details on the response codes that are returned please see the Response Codes table
ISO Code 2 – character numeric receipt.getISO(); ISO response code return from issuing institution. For further details on the response codes that are returned please see the Response Codes table
Authorization Code 8 – character alphanumeric receipt.getAuthCode(); Authorization code returned from the issuing institution.
Transaction Time ##:##:## receipt.getTransTime(); Processing host time stamp (24 hour clock).
Transaction Date yyyy-mm-dd receipt.getTransDate(); Processing host date stamp.
Transaction Type 2 – character numeric receipt.getTransType();
  • Type of transaction that was performed:
  • 00 = Purchase, ACH Debit, Vault Credit Card Purchase, Vault ACH Purchase
  • 01 = Preauthorization, Vault Credit Card Pre-Authorization
  • 02 = Pre-Authorization Completion
  • 04 = Refund, Independent Refund, ACH Credit, Vault Credit Card & ACH Independent Refund
  • 11 = Purchase Correction, ACH Reversal
Complete true/false receipt.getComplete(); Transaction was sent to authorization host and a response was received
Message 100 – character alphanumeric receipt.getMessage(); Response description returned from issuing institution. This message should not be displayed on any cardholder facing materials.  For receipt purposes, please refer to the Receipt Requirements
Transaction Amount 9 - decimal receipt.getTransAmount(); Returns the transaction amount from the request.
Card Type 2 – character alphanumeric receipt.getCardType(); Card Type M = MasterCard V = Visa AX = American Express NO = Novus/Discover in (Canada only) DS= Discover (US only) C = JCB (US only) C1 = JCB (Canada only) SE = Sears (Canada only) CQ = ACH (US only) P = Pin Debit (US only) D = Debit (Canada only)
Transaction Number 20 - character alphanumeric receipt.getTxnNumber(); Gateway Transaction identifier. This field is required for any future follow-on transactions such as Refunds, Corrections, Completions, Reversals, etc.
Timed Out true/false receipt.getTimedOut(); Indicates if a transaction failed due to a process timing out.
Bank Totals Object receipt.getBankTotals(); Response data returned in a Batch Close and Open Totals request. Refer to Batch Close Response Fields below for further breakdown.
Ticket   receipt.getTicket(); Reserved field.

Other Response Fields

VALUE LIMITS GET METHOD DESCRIPTION
Card Level Result 3 – character alphanumeric receipt.getCardLevelResult(); (US only) Returns the product ID for the Visa or MC card program from the issuer.  For a list of all Visa and MasterCard Card Level Result values refer to the Card Level Result Value table.
Is Visa Debit true/false receipt.getIsVisaDebit(); (Canada only) Indicates whether the card processed is a Visa Debit.
Corporate Card true/false receipt.getCorporateCard(); Indicates whether the card or the card on file in the vault is a corporate card.

Batch Close / Open Totals Response Fields

VALUE LIMITS VARIABLE DESCRIPTION
Processed Card Type String Array receipt.getCreditCards(ecr_no); Returns all of the processed card types in the current batch for the terminal ID/ECR Number from the request.
Terminals IDs 8 – character alphanumeric receipt.getTerminalIDs(); Returns the terminal ID/ECR Number from the request.
Purchase Count 4 – character numeric receipt.getPurchaseCount(ecr, cardType); Indicates the # of Purchase, ACH debit, Pre-Authorization Completion and Force Post transactions processed. If none were processed in the batch, then 0000 will be returned.
Purchase Amount 11 – character alphanumeric receipt.getPurchaseAmount(ecr, cardType); Indicates the dollar amount processed for Purchase, ACH debit, Pre-Authorization Completion or Force Post transactions.  This field begins with a + and is followed by 10 numbers, the first 8 indicate the amount and the last 2 indicate the penny value. Example, +0000000000 = 0.00  and +0000041625 = 416.25
Refund Count 4 – character numeric receipt.getRefundCount(ecr, cardType); Indicates the # of Refund, Independent Refund or ACH Credit transactions processed. If none were processed in the batch, then 0000 will be returned.
Refund Amount 11 – character alphanumeric receipt.getRefundAmount(ecr, cardType); Indicates the dollar amount processed for Refund, Independent Refund or ACH Credit transactions.  This field begins with a + and is followed by 10 numbers, the first 8 indicate the amount and the last 2 indicate the penny value. Example, +0000000000 = 0.00  and +0000041625 = 416.25
Correction Count 4 – character numeric receipt.getCorrectionCount(ecr, cardType); Indicates the # of Purchase Correction or ACH Reversal transactions processed. If none were processed in the batch, then 0000 will be returned.
Correction Amount 11 – character alphanumeric receipt.getCorrectionAmount(ecr, cardType); Indicates the dollar amount processed for Purchase Correction or ACH Reversal transactions.  This field begins with a + and is followed by 10 numbers, the first 8 indicate the amount and the last 2 indicate the penny value. Example, +0000000000 = 0.00  and +0000041625 = 416.25

CVD and AVS Response Fields

Value Limits Get Method Description
CVD result code 2-character alphanumeric receipt.getCvdResultCode(); Indicates the CVD validation result. The first byte is the numeric CVD indicator sent in the request; the second byte is the response code. Possible response codes are shown in the CVD Result Code table.
AVS result code 1-character alphanumeric receipt.getAvsResultCode(); Indicates the address verification result. For a full list of possible response codes refer to the AVS Result Code table.

Status Check Response Fields

Value Limits Get Method Description

Status Code

3-character alphanumeric

receipt.getStatusCode();

The StatusCode is populated when status_check is set to “true” in the request.

<50: Transaction found

>=50: Transaction not found

Status Message

found/not found

receipt.getStatusMessage();

The StatusMsg is populated when status_check is set to “true” in the request.


3-D Secure Response Fields

Value Limits Get method Description
CAVV result code 1-character alphanumeric receipt.getCavvResultCode(); Indicates the Verified by Visa CAVV result. Possible response codes are shown in the CAVV Result Code table

Recurring Billing Response Fields

Value Limits Get method Description
Recurring billing success true/false receipt.getRecurSuccess(); Indicates whether the recurring billing transaction has been successfully set up for future billing.

Recurring billing

update success

 true/false

receipt.getRecurUpdateSuccess();

Indicates whether the recurring billing transaction has been successfully set up for future billing.

Next recurring billing date

yyyy-mm-dd

receipt.getNextRecurDate();

Indicates when the transaction will be billed again (recur).

Recurring billing end date

yyyy-mm-dd

receipt.getRecurEndDate();

Indicates when the Recurring Billing transaction will end.


Convenience Fee Response Fields

VALUE LIMITS GET METHOD DESCRIPTION
Convenience fee success true/false receipt.getCfSuccess(); Indicates whether the Convenience Fee transaction processed successfully.
Convenience fee status 2-character alphanumeric receipt.getCfStatus(); Indicates the status of the merchant and convenience fee transactions. The CfStatus field provides details about the transaction behavior and should be referenced when contacting Moneris Customer Support.
Possible values are:
1 or 1F – Completed 1st purchase transaction
2 or 2F – Completed 2nd purchase transaction
3 – Completed void transaction
4A or 4D – Completed refund transaction
7 or 7F – Completed merchant independent refund transaction
8 or 8F – Completed merchant refund transaction
9 or 9F – Completed 1st void transaction
10 or 10F – Completed 2nd void transaction
11A or 11D – Completed refund transaction
Convenience fee amount 9-character decimal rreceipt.getFeeAmount(); The expected Convenience Fee amount. This field will return the amount submitted by the merchant for a successful transaction. For an unsuccessful transaction, it will return the expected convenience fee amount.
Convenience fee rate 9-character decimal receipt.getFeeRate(); The convenience fee rate that has been defined on the merchant’s profile. For example:
1.00 – a fixed amount or
10.0 - a percentage amount
Convenience fee type AMT/PCT receipt.getFeeType(); The type of convenience fee that has been defined on the merchant’s profile.
Available options are:
AMT – fixed amount
PCT – percentage

Vault Response Fields

Value Limits Get Method Description
Data Key 25-character alphanumeric receipt.getDataKey(); This field is created when a profile is created and a token is returned.
It is a unique profile identifier, and is a required value for all future Vault transactions.
Vault Success true/false receipt.getResSuccess(); Indicates whether Vault transaction was successful.
Payment Type cc/ach receipt.getPaymentType(); Indicates the payment type associated with a Vault profile.
Customer ID 30-character alphanumeric receipt.getResCustId(); Returns the customer ID saved in the profile.
Phone Number 30-character alphanumeric receipt.getResPhone(); Returns the phone number saved in the profile.
Email Address 30-character alphanumeric receipt.getResEmail(); Returns the email address saved in the profile.
Note 30-character alphanumeric receipt.getResNote(); Returns the note saved in the profile.
ACH Fields
SEC Code 3-character alphanumeric receipt.getResSec(); Returns the ACH SEC code saved in the profile.
Customer First Name 50-character alphanumeric receipt.getResCustFirstName(); Returns the customer first name saved in the profile.
Customer Last Name 50-character alphanumeric receipt.getResCustLastName(); Returns the customer last name saved in the profile.
Customer Address 1 50-character alphanumeric receipt.getResCustAddress1(); Returns the customer address line 1 saved in the profile.
Customer Address 2 50-character alphanumeric receipt.getResCustAddress2(); Returns the customer address line 2 saved in the profile.
Customer City 50-character alphanumeric receipt.getResCustCity(); Returns the customer city saved in the profile.
Customer State 2-character alphanumeric receipt.getResCustState(); Returns the customer state code saved in the profile.
Customer Zip Code 10-character numeric receipt.getResCustZip(); Returns the customer zip code saved in the profile.
Check Routing Number 9-character numeric receipt.getResRoutingNum(); Returns the customer check routing number saved in the profile.
Masked Account Number 15-character alphanumeric receipt.getResMaskedAccountNum(); Returns the masked first 4 last 4 of the account number saved in the profile.
Account Number 15-character alphanumeric receipt.getResAccountNum(); Returns the full account number saved in the profile.
Check Number 16-character numeric receipt.getResCheckNum(); Returns the check number saved in the profile.
Account Type savings/checking receipt.getResAccountType(); Returns the type of account saved in the profile.
Credit Card Fields
Masked PAN 20-character numeric receipt.getResMaskedPan(); Returns the first 4 last 4 of the card number saved in the profile.
PAN 20-character numeric receipt.getResPan(); Returns the full card number saved in the profile.
Expiry Date 4-character numeric receipt.getResExpdate(); Returns the expiry date of the card number saved in the profile. YYMM format.
E-Commerce Indicator 1-character numeric receipt.getResCryptType(); Returns the e-commerce indicator saved in the profile.
AVS Street Number 19-character alphanumeric receipt.getResAvsStreetNumber(); Returns the AVS street number saved in the profile. If no other AVS street number is passed in the transaction request, this value will be submitted along with the financial transaction to the issuer.
AVS Street Name 19-character alphanumeric receipt.getResAvsStreetName(); Returns the AVS street name saved in the profile. If no other AVS street number is passed in the transaction request, this value will be submitted along with the financial transaction to the issuer.
AVS Zip/Postal Code 9-character alphanumeric receipt.getResAvsZipcode(); Returns the AVS zip/postal code saved in the profile. If no other AVS street number is passed in the transaction request, this value will be submitted along with the financial transaction to the issuer.
Get Expiring Fields
Expiring card's payment type cc receipt.getExpPaymentType(); Indicates the payment type associated with a Vault profile.
Expiring card's Customer ID 30-character alphanumeric receipt.getExpCustId(); Returns the customer ID saved in the profile.
Expiring card's Phone Number 30-character alphanumeric receipt.getExpPhone(); Returns the phone number saved in the profile.
Expiring card's Email Address 30-character alphanumeric receipt.getExpEmail(); Returns the email address saved in the profile.
Expiring card's Note 30-character alphanumeric receipt.getExpNote(); Returns the note saved in the profile.
Get Expiring Credit Card Fields
Expiring card's Masked PAN 20-character numeric receipt.getExpMaskedPan(); Returns the first 4 last 4 of the card number saved in the profile.
Expiring card's Expiry Date 4-character numeric receipt.getExpExpdate(); Returns the expiry date of the card number saved in the profile. YYMM format.
Expiring card's E-Commerce Indicator 1-character numeric receipt.getExpCryptType(); Returns the e-commerce indicator saved in the profile.
Expiring card's AVS Street Number 19-character alphanumeric receipt.getExpAvsStreetNumber(); Returns the AVS street number saved in the profile. If no other AVS street number is passed in the transaction request, this value will be submitted along with the financial transaction to the issuer.
Expiring card's AVS Street Name 19-character alphanumeric receipt.getExpAvsStreetName(); Returns the AVS street name saved in the profile. If no other AVS street number is passed in the transaction request, this value will be submitted along with the financial transaction to the issuer.
Expiring card's AVS Zip/Postal Code 9-character alphanumeric receipt.getExpAvsZipcode(); Returns the AVS zip/postal code saved in the profile. If no other AVS street number is passed in the transaction request, this value will be submitted along with the financial transaction to the issuer.