November 2018
Canada Only
Page 111 of 486
Moneris Gateway API - Integration Guide
5.5.2 Online Banking Response and Fund-Confirmation Request
The response variables are posted back in an HTML form to either the funded or non-funded URL that
was provided to INTERAC®.
The following variables must be validated (5.8, page 117):
l
l
l
l
l
l
IDEBIT_TRACK2
IDEBIT_ISSCONF
IDEBIT_ISSNAME
IDEBIT_VERSION
IDEBIT_ISSLANG
IDEBIT_INVOICE
Note that IDEBIT_ISSCONF and IDEBIT_ISSNAME must be displayed on the client’s receipt that is generated by the merchant.
After validation, IDEBIT_TRACK2 is used to form an IDebitPurchase transaction that is sent to Moneris
Gateway to confirm the fund.
If the validation fails, redirect the client to the main page and ask for a different means of payment.
If the validation passes, an IDebitPurchase transaction can be sent to Moneris Gateway.
5.6 INTERAC® Online Payment Purchase
INTERAC® Online Payment Purchase transaction object definition
IDebitPurchase IOP_Txn = new IDebitPurchase();
HttpsPostRequest object for INTERAC® Online Payment Purchase transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(IOP_Txn);
INTERAC® Online Payment Purchase transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Page 112 of 486
Canada Only
November 2018
5 INTERAC® Online Payment
Table 48: INTERAC® Online Payment transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
IOP_Txn.SetOrderId(order_id);
Amount
String
10-character decimal
IOP_Txn.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Track2 data
String
IOP_Txn.SetTrack2(track2);
40-character alphanumeric
Table 49: INTERAC® Online Payment Purchase transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
IOP_Txn.SetCustId(cust_id);
Dynamic
descriptor
String
20-character alphanumeric
IOP_Txn.SetDynamicDescriptor
(dynamic_descriptor);
Customer
information
Object
Not applicable. Click hereSee IOP_Txn.SetCustInfo(customer);
Section 14 (page 363).
Sample INTERAC® Online Payment Purchase
namespace Moneris
{
using System;
public class TestCanadaIDebitPurchase
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "Lance_Briggs_55";
string amount = "5.00";
string track2 = "5268051119993326=0609AAAAAAAAAAAAA000";
string processing_country_code = "CA";
bool status_check = false;
/********************* Billing/Shipping Variables ****************************/
string first_name = "Bob";
November 2018
Canada Only
Page 113 of 486
Moneris Gateway API - Integration Guide
Sample INTERAC® Online Payment Purchase
string last_name = "Smith";
string company_name = "ProLine Inc.";
string address = "623 Bears Ave";
string city = "Chicago";
string province = "Illinois";
string postal_code = "M1M2M1";
string country = "Canada";
string phone = "777-999-7777";
string fax = "777-999-7778";
string tax1 = "10.00";
string tax2 = "5.78";
string tax3 = "4.56";
string shipping_cost = "10.00";
/********************* Order Line Item Variables *****************************/
string[] item_description = new string[] { "Chicago Bears Helmet", "Soldier Field Poster" };
string[] item_quantity = new string[] { "1", "1" };
string[] item_product_code = new string[] { "CB3450", "SF998S" };
string[] item_extended_amount = new string[] { "150.00", "19.79" };
/********************** Customer Information Object **************************/
CustInfo customer = new CustInfo();
/********************** Set Customer Billing Information **********************/
customer.SetBilling(first_name, last_name, company_name, address, city,
province, postal_code, country, phone, fax, tax1, tax2,
tax3, shipping_cost);
/******************** Set Customer Shipping Information ***********************/
customer.SetShipping(first_name, last_name, company_name, address, city,
province, postal_code, country, phone, fax, tax1, tax2,
tax3, shipping_cost);
/***************************** Order Line Items ******************************/
customer.SetItem(item_description[0], item_quantity[0],
item_product_code[0], item_extended_amount[0]);
customer.SetItem(item_description[1], item_quantity[1],
item_product_code[1], item_extended_amount[1]);
/************************** Request *************************/
IDebitPurchase IOP_Txn = new IDebitPurchase();
IOP_Txn.SetOrderId(order_id);
IOP_Txn.SetCustId(cust_id);
IOP_Txn.SetAmount(amount);
IOP_Txn.SetIdebitTrack2(track2);
IOP_Txn.SetCustInfo(customer);
//IOP_Txn.SetDynamicDescriptor("dynamicdescriptor1");
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(IOP_Txn);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Page 114 of 486
Canada Only
November 2018
5 INTERAC® Online Payment
Sample INTERAC® Online Payment Purchase
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
5.7 INTERAC® Online Payment Refund
To process this transaction, you need the order ID and transaction number from the original INTERAC®
Online Payment Purchase transaction.
INTERAC® Online Payment Refund transaction object definition
IDebitRefund refund = new IDebitRefund();
HttpsPostRequest object for INTERAC® Online Payment Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(refund);
INTERAC® Online Payment Refund transaction object values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
November 2018
Canada Only
Page 115 of 486
Moneris Gateway API - Integration Guide
Table 50: INTERAC® Online Payment Refund transaction object mandatory variables
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
refund.SetOrderId(order_id);
Amount
String
10-character decimal
refund.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Transaction number
String
255-character alphanumeric
refund.SetTxnNumber(txn_
number);
Table 51: INTERAC® Online Payment Refund transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
refund.SetCustId(cust_id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Sample code
Sample INTERAC® Online Payment Refund
namespace Moneris
{
using System;
public class TestCanadaIDebitRefund
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test20150625014816";
string amount = "5.00";
string txn_number = "113524-0_10";
string processing_country_code = "CA";
bool status_check = false;
IDebitRefund refund = new IDebitRefund();
refund.SetOrderId(order_id);
Page 116 of 486
Canada Only
November 2018
5 INTERAC® Online Payment
Sample INTERAC® Online Payment Refund
refund.SetAmount(amount);
refund.SetTxnNumber(txn_number);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(refund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
5.8 INTERAC® Online Payment Field Definitions
Table 52: Field Definitions
Characters
Limits
Value
Description
IDEBIT_
MERCHNUM
5-14
Numbers and uppercase letters
This field is provided by Moneris. For example, 0003MONMPGXXXX.
IDEBIT_TERMID 8
Numbers and uppercase letters
Optional field
November 2018
Canada Only
Page 117 of 486
Moneris Gateway API - Integration Guide
Table 52: Field Definitions (continued)
Characters
Limits
Value
Description
IDEBIT_
AMOUNT
1-12
IDEBIT_
CURRENCY
3
Numbers
Amount expressed in cents (for example, 1245 for $12.45) to charge to the card.
"CAD" or "USD"
National currency of the transaction.
IDEBIT_INVOICE 1-20
ISO-8859-1 encoded characters restricted to:
l
l
l
l
l
Uppercase and lowercase
Numbers
ÀÁÂÄÈÉÊËÎ Ï Ô ÙÛÜÇàáâäèéêëîïôù û ü ÿ ç
Spaces
#$. , -/ =?@'
Optional field
Can be the Order ID when used with Moneris Gateway fund confirmation transactions.
IDEBIT_
MERCHDATA
1024
ISO-8859-1 restricted to single-byte codes, hex 20 to 7E (consistent with
US-ASCII and ISO-8859-1 Latin-1).
Note that the following character combinations may not be accepted in
the IDEBIT_MERCHDATA field:
l
"/..", "/%2E.", "/.%2E", "/%2E%2E", "\\%2E%2E", "\\%2E.",
"\\.%2E", "\\%2E%2E", "&#", "<", "%3C", ">", "%3E"
Free form data provided by the merchant that will be passed back unchanged to the
merchant once the payment has been guaranteed in online banking.
This may be used to identify the customer, session or both.
IDEBIT_
FUNDEDURL
1024
ISO-8859-1 restricted to single-byte codes, restricted to:
l
l
l
Uppercase and lowercase letters
Numbers
;/ ?:@&=+$, -_. !~*‘ ()%
Https address to which the issuer will redirect cardholders after guaranteeing the
fund through online banking.
Page 118 of 486
Canada Only
November 2018
5 INTERAC® Online Payment
Table 52: Field Definitions (continued)
Characters
Limits
Value
Description
IDEBIT_
1024
NOTFUNDEDURL
ISO-8859-1, restricted to single-byte codes, restricted to:
l
l
l
Uppercase and lowercase letters
Numbers
;/ ?:@&=+$, -_. !~*‘ ()%
Https address to which the issuer redirects cardholders after failing or canceling the
online banking process.
IDEBIT_
MERCHLANG
2
“en” or “fr”
Customer's current language at merchant.
IDEBIT_VERSION 3
Numbers
Initially, the value is 1.
IDEBIT_ISSLANG 2
“en” or “fr”
Customer’s current language at issuer.
IDEBIT_TRACK2
37
ISO-8859-1 (restricted to single-byte codes), hex 20 to 7E (consistent with
US-ASCII and ISO-8859-1 Latin-1)
Value returned by the issuer. It includes the PAN, expiry date, and transaction ID.
IDEBIT_ISSCONF 15
ISO-8859-1 encoded characters restricted to:
l
l
l
l
l
Uppercase and lowercase letters
Numbers
ÀÁÂÄÈÉÊËÎ Ï Ô ÙÛÜÇàáâäèéêëîïôù û ü ÿ ç
Spaces
#$. , -/ =?@'
Confirmation number returned from the issuer to be displayed on the merchant’s
confirmation page and on the receipt.
IDEBIT_
ISSNAME
30
ISO-8859-1 encoded characters restricted to:
l
l
l
l
l
Uppercase and lowercase letters
Numbers
ÀÁÂÄÈÉÊËÎ Ï Ô ÙÛÜÇàáâäèéêëîïôù û ü ÿ ç
Spaces
#$. , -/ =?@•'
Issuer name to be displayed on the merchant’s confirmation page and on the
receipt.
November 2018
Canada Only
Page 119 of 486
6 Mag Swipe Transaction Set
l
l
l
l
l
l
l
l
6.1 Mag Swipe Transaction Type Definitions
6.2 Mag Swipe Purchase
l 6.2.1 Encrypted Mag Swipe Purchase
6.3 Mag Swipe Pre-Authorization
l 6.3.1 Encrypted Mag Swipe Pre-Authorization
6.4 Mag Swipe Completion
6.5 Mag Swipe Force Post
l 6.5.1 Encrypted Mag Swipe Force Post
6.6 Mag Swipe Purchase Correction
6.7 Mag Swipe Refund
6.8 Mag Swipe Independent Refund
l 6.8.1 Encrypted Mag Swipe Independent Refund
Mag Swipe transactions allow customers to swipe a credit card and submit the Track2 details.
These transactions support the submission of Track2 as well as a manual entry of the credit card number
and expiry date. If all three fields are submitted, the Track2 details are used to process the transaction.
6.1 Mag Swipe Transaction Type Definitions
Purchase
Verifies funds on the customer’s card, removes the funds and prepares them for deposit into
the merchant’s account.
Pre-Authorization
Verifies and locks funds on the customer’s credit card. The funds are locked for a specified
amount of time based on the card issuer.
To retrieve the funds that have been locked by a Pre-Authorization transaction so that they
may be settled in the merchant’s account, a Completion transaction must be performed. A
Pre-Authorization may only be "completed" once.
Completion
Retrieves funds that have been locked (by a Mag Swipe Pre-Authorization transaction), and
prepares them for settlement into the merchant’s account.
Force Post
Retrieves the locked funds and prepares them for settlement into the merchant’s account.
This is used when a merchant obtains the authorization number directly from the issuer by a
third-party authorization method (such as by phone).
Purchase Correction
Restores the full amount of a previous Mag Swipe Purchase or Mag Swipe Completion transaction to the cardholder's card, and removes any record of it from the cardholder's statement. The order ID and transaction number from the original transaction are required, but
the credit card does not need to be re-swiped.
This transaction can be used against a Purchase or Completion transaction that occurred
same day provided that the batch containing the original transaction remains open. When
using the automated closing feature, Batch Close occurs daily between 10 and 11 pm Eastern
Time.
November 2018
Page 120 of 486
Moneris Gateway API - Integration Guide
This transaction is sometimes referred to as "void".
Refund
Restores all or part of the funds from a Mag Swipe Purchase or Mag Swipe Completion transaction to the cardholder's card. Unlike a Purchase Correction, there is a record of the refund.
Independent Refund
Credits a specified amount to the cardholder’s credit card.
This does not require a previous transaction (such as Mag Swipe Purchase) to be logged in the
Moneris Gateway. However, a credit card must be swiped to provide the Track2 data.
6.1.1 Encrypted Mag Swipe Transactions
Encrypted Mag Swipe transactions allow the customer to swipe or key in a credit card using a Monerisprovided encrypted mag swipe reader, and submit the encrypted Track2 details.
The encrypted mag swipe reader can be used for processing:
l
l
l
Swiped card-present transactions
Manually keyed card-present transactions
Manually keyed card-not-present transactions.
Encrypted Mag Swipe transactions are identical to the regular Mag Swipe transactions from the customer's perspective. However, the card data must be swiped or keyed in via a Moneris-provided encrypted mag swipe reader. Contact Moneris for more details.
Only Mag Swipe Purchase and Mag Swipe Pre-Authorization have encrypted versions. Their explanations
appear in this document as subsections of the regular (unencrypted) Mag Swipe Purchase and Mag
Swipe Pre-Authorization transactions respectively.
6.2 Mag Swipe Purchase
Mag Swipe Purchase transaction object definition
Track2Purchase track2purchase = new Track2Purchase();
HttpsPostRequest object for Mag Swipe Purchase transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(track2purchase);
Mag Swipe Purchase transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Page 121 of 486
November 2018
6 Mag Swipe Transaction Set
Table 53: Mag Swipe Purchase transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
track2purchase.SetOrderId
(order_id);
Amount
String
10-character decimal
track2purchase.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
20-character numeric
track2purchase.SetPan(pan);
OR
OR
OR
Track2 data
40-character numeric
track2purchase.SetTrack2
(track2);
4-character alphanumeric
track2purchase.SetExpdate
(expiry_date);
Credit card number
Expiry date
String
String
(YYMM format)
POS code
String
2-character numeric
track2purchase.SetPosCode
(pos_code);
Table 54: Mag Swipe Purchase transaction optional values
Value
Type
Limits
Set method
AVS information
Object
N/A
track2purchase.SetAvsInfo
(avsCheck);
Customer ID
String
50-character alphanumeric
track2purchase.SetCustId
(cust_id);
CVD information
Object
N/A
track2purchase.SetCvdInfo
(cvdCheck);
November 2018
Page 122 of 486
Moneris Gateway API - Integration Guide
Table 54: Mag Swipe Purchase transaction optional values
Value
Type
Limits
Set method
Dynamic descriptor
String
20-character alphanumeric
track2purchase
.SetDynamicDescriptor
(dynamic_descriptor);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Sample Mag Swipe Purchase
namespace Moneris
{
using System;
using System.Text.RegularExpressions;
public class TestCanadaTrack2Purchase
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "LBriggs";
string amount = "1.00";
string track2 = "";
//string track2 = ";5258968987035454=06061015454001060101?";
string pan = "4242424242424242";
string exp_date = "1903"; //must send '0000' if swiped
string pos_code = "00";
string processing_country_code = "CA";
bool status_check = false;
Track2Purchase track2purchase = new Track2Purchase();
track2purchase.SetOrderId(order_id);
track2purchase.SetCustId(cust_id);
track2purchase.SetAmount(amount);
track2purchase.SetTrack2(track2);
track2purchase.SetPan(pan);
track2purchase.SetExpdate(exp_date);
track2purchase.SetPosCode(pos_code);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(track2purchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Page 123 of 486
November 2018
6 Mag Swipe Transaction Set
Sample Mag Swipe Purchase
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.2.1 Encrypted Mag Swipe Purchase
Encrypted Mag Swipe Purchase transaction object definition
EncTrack2Purchase encpurchase = new EncTrack2Purchase();
HttpsPostRequest object for Encrypted Mag Swipe Purchase transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(encpurchase);
Encrypted Mag Swipe Purchase transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
November 2018
Page 124 of 486
Moneris Gateway API - Integration Guide
Table 55: Encrypted Mag Swipe Purchase transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
encpurchase.SetOrderId(order_
id);
Amount
String
10-character decimal
encpurchase.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Encrypted Track2 data
String
n/a
encpurchase.SetEncTrack2(enc_
track2);
POS code
String
2-character numeric
encpurchase.SetPosCode(pos_
code);
Device type
String
30-character alphanumeric
encpurchase.SetDeviceType
(device_type);
Table 56: Encrypted Mag Swipe Purchase transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
encpurchase.SetCustId(cust_
id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
AVS information
Object
n/a
encpurchase.SetAvsInfo
(avsCheck);
Dynamic descriptor
String
20-character alphanumeric
encpurchase
.SetDynamicDescriptor
(dynamic_descriptor);
Sample Encrypted Mag Swipe Purchase
namespace Moneris
{
Page 125 of 486
November 2018
6 Mag Swipe Transaction Set
Sample Encrypted Mag Swipe Purchase
using System;
using System.Text.RegularExpressions;
public class TestCanadaEncTrack2Purchase
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "LBriggs";
string amount = "1.00";
string pos_code = "00";
string device_type = "idtech_bdk";
string processing_country_code = "CA";
bool status_check = false;
string dynamic_descriptor = "my descriptor";
string enc_track2 = "ENCRYPTEDTRACK2DATA";
EncTrack2Purchase encpurchase = new EncTrack2Purchase();
encpurchase.SetOrderId(order_id);
encpurchase.SetCustId(cust_id);
encpurchase.SetAmount(amount);
encpurchase.SetEncTrack2(enc_track2);
encpurchase.SetPosCode(pos_code);
encpurchase.SetDeviceType(device_type);
encpurchase.SetDynamicDescriptor(dynamic_descriptor);
AvsInfo avsCheck = new AvsInfo();
avsCheck.SetAvsStreetNumber("212");
avsCheck.SetAvsStreetName("Payton Street");
avsCheck.SetAvsZipCode("M1M1M1");
encpurchase.SetAvsInfo(avsCheck);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(encpurchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("MaskedPan = " + receipt.GetMaskedPan());
Console.WriteLine("CardLevelResult = " + receipt.GetCardLevelResult());
Console.WriteLine("AVS Response = " + receipt.GetAvsResultCode());
November 2018
Page 126 of 486
Moneris Gateway API - Integration Guide
Sample Encrypted Mag Swipe Purchase
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.3 Mag Swipe Pre-Authorization
Mag Swipe Pre-Authorization transaction object definition
Track2PreAuth track2preauth = new Track2PreAuth();
HttpsPostRequest object for Mag Swipe Pre-Authorization transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(track2preauth);
Mag Swipe Pre-Authorization transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 57: Mag Swipe Pre-Authorization transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
track2preauth.SetOrderId
(order_id);
Amount
String
10-character decimal
track2preauth.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
20-character numeric
track2preauth.SetPan(pan);
OR
OR
OR
Track2 data
40-character numeric
track2preauth.SetPan(pan);
4-character alpha-
track2preauth.SetExpdate
(expiry_date);
Credit card number
Expiry date
Page 127 of 486
String
String
November 2018
6 Mag Swipe Transaction Set
Table 57: Mag Swipe Pre-Authorization transaction object mandatory values (continued)
Value
Type
Limits
Set method
numeric
(YYMM format)
POS code
String
2-character numeric
track2preauth.SetPosCode(pos_
code);
Table 58: Mag Swipe Pre-Authorization transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
track2preauth.SetCustId(cust_
id);
Dynamic descriptor
String
20-character alphanumeric
track2preauth
.SetDynamicDescriptor
(dynamic_descriptor);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Sample Mag Swipe Pre-Authorization
namespace Moneris
{
using System;
using System.Text.RegularExpressions;
public class TestCanadaTrack2Preauth
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "LBriggs";
string amount = "5.00";
//string track2 = ";5258968987035454=06061015454001060101?";
string track2 = "";
string pan = "4242424242424242";
string exp = "1906"; //must send '0000' if swiped
string pos_code = "00";
string processing_country_code = "CA";
bool status_check = false;
Track2PreAuth track2preauth = new Track2PreAuth();
track2preauth.SetOrderId(order_id);
track2preauth.SetCustId(cust_id);
track2preauth.SetAmount(amount);
track2preauth.SetTrack2(track2);
track2preauth.SetPan(pan);
track2preauth.SetExpdate(exp);
track2preauth.SetPosCode(pos_code);
November 2018
Page 128 of 486
Moneris Gateway API - Integration Guide
Sample Mag Swipe Pre-Authorization
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(track2preauth);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.3.1 Encrypted Mag Swipe Pre-Authorization
Encrypted Mag Swipe Pre-Authorization transaction object definition
EncTrack2PreAuth enctrack2preauth = new EncTrack2PreAuth();
HttpsPostRequest object for Encrypted Mag Swipe Pre-Authorization transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(enctrack2preauth);
Encrypted Mag Swipe Pre-Authorization transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Page 129 of 486
November 2018
6 Mag Swipe Transaction Set
Table 59: Encrypted Mag Swipe Pre-Authorization transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
enctrack2preauth.SetOrderId
(order_id);
Amount
String
10-character decimal
enctrack2preauth.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
20-character numeric
enctrack2preauth.SetPan(pan);
OR
OR
OR
Encrypted Track2
n/a
enctrack2preauth.SetEncTrack2
(enc_track2);
Credit card number
String
POS code
String
2-character numeric
enctrack2preauth.SetPosCode
(pos_code);
Device type
String
30-character alphanumeric
enctrack2preauth
.SetDeviceType(device_type);
Table 60: Encrypted Mag Swipe Pre-Authorization transaction optional values
Value
Type
Limits
Customer ID
String
50-character alphanumeric
Status Check
Boolean
true/false
Set method
enctrack2preauth.SetCustId
(cust_id);
mpgReq.SetStatusCheck(status_
check);
Sample Encrypted Mag Swipe Pre-Authorization
namespace Moneris
{
using System;
using System.Text.RegularExpressions;
public class TestCanadaEncTrack2Preauth
{
public static void Main(string[] args)
{
November 2018
Page 130 of 486
Moneris Gateway API - Integration Guide
Sample Encrypted Mag Swipe Pre-Authorization
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "LBriggs";
string amount = "5.00";
string pos_code = "00";
string device_type = "idtech_bdk";
string processing_country_code = "CA";
bool status_check = false;
string enc_track2 = "ENCRYPTEDTRACK2DATA";
string descriptor = "nqa";
EncTrack2PreAuth enctrack2preauth = new EncTrack2PreAuth();
enctrack2preauth.SetOrderId(order_id);
enctrack2preauth.SetCustId(cust_id);
enctrack2preauth.SetAmount(amount);
enctrack2preauth.SetEncTrack2(enc_track2);
enctrack2preauth.SetPosCode(pos_code);
enctrack2preauth.SetDeviceType(device_type);
enctrack2preauth.SetDynamicDescriptor(descriptor);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(enctrack2preauth);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("MaskedPan = " + receipt.GetMaskedPan());
Console.WriteLine("CardLevelResult = " + receipt.GetCardLevelResult());
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
Page 131 of 486
November 2018
6 Mag Swipe Transaction Set
6.4 Mag Swipe Completion
Mag Swipe Completion transaction object definition
Track2Completion track2completion = new Track2Completion();
HttpsPostRequest object for Mag Swipe Completion transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(track2completion);
Mag Swipe Completion transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 61: Mag Swipe Completion transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
track2completion.SetOrderId
(order_id);
Transaction number
String
255-character
track2completion.SetTxnNumber
(txn_number);
variable character
Completion Amount
String
10-character decimal
track2completion.SetCompAmount
(comp_amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
POS code
String
2-character numeric
track2completion.SetPosCode
(pos_code);
Table 62: Mag Swipe Completion transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
track2completion.SetCustId
(cust_id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Dynamic descriptor
String
20-character alpha-
track2completion
.SetDynamicDescriptor
November 2018
Page 132 of 486
Moneris Gateway API - Integration Guide
Table 62: Mag Swipe Completion transaction optional values (continued)
Value
Type
Limits
numeric
Set method
(dynamic_descriptor);
Sample Mag Swipe Completion
namespace Moneris
{
using System;
public class TestCanadaTrack2Completion
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string order_id = "Test20150625035422";
string txn_number = "87028-0_10";
string amount = "1.00";
string pos_code = "00";
string dynamic_descriptor = "123456";
string processing_country_code = "CA";
bool status_check = false;
Track2Completion track2completion = new Track2Completion();
track2completion.SetOrderId(order_id);
track2completion.SetTxnNumber(txn_number);
track2completion.SetAmount(amount);
track2completion.SetPosCode(pos_code);
track2completion.SetDynamicDescriptor(dynamic_descriptor);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(track2completion);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Page 133 of 486
November 2018
6 Mag Swipe Transaction Set
Sample Mag Swipe Completion
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.5 Mag Swipe Force Post
Mag Swipe Force Post transaction object definition
Track2ForcePost track2forcePost = new Track2ForcePost();
HttpsPostRequest object for Mag Swipe Force Post transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(track2forcePost);
Mag Swipe Force Post transaction mandatory arguments
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 63: Mag Swipe Force Post transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
track2forcePost.SetOrderId
(order_id);
Amount
String
10-character decimal
track2forcePost.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
20-character numeric
track2forcePost.SetPan(pan);
OR
OR
OR
Track2 data
40-character numeric
track2forcePost.SetTrack2
(track2);
Credit card number
November 2018
String
Page 134 of 486
Moneris Gateway API - Integration Guide
Table 63: Mag Swipe Force Post transaction object mandatory values
Value
Expiry date
Type
String
Limits
4-character alphanumeric
Set method
track2forcePost.SetExpdate
(expiry_date);
(YYMM format)
POS code
String
2-character numeric
track2forcePost.SetPosCode
(pos_code);
Authorization code
String
8-character alphanumeric
track2forcePost.SetAuthCode
(auth_code);
Table 64: Mag Swipe Force Post transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
track2forcePost.SetCustId
(cust_id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Dynamic descriptor
String
20-character alphanumeric
track2forcePost
.SetDynamicDescriptor
(dynamic_descriptor);
Sample Mag Swipe Force Post
namespace Moneris
{
using System;
public class TestCanadaTrack2ForcePost
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string amount = "10.00";
string track2 = "";
string pan = "4242424242424242";
string expiry_date = "1212";
string pos_code = "00";
string auth_code = "AU4R6";
string processing_country_code = "CA";
bool status_check = false;
Track2ForcePost track2forcePost = new Track2ForcePost();
track2forcePost.SetOrderId(order_id);
track2forcePost.SetAmount(amount);
Page 135 of 486
November 2018
6 Mag Swipe Transaction Set
Sample Mag Swipe Force Post
track2forcePost.SetTrack2(track2);
track2forcePost.SetPan(pan);
track2forcePost.SetExpdate(expiry_date);
track2forcePost.SetPosCode(pos_code);
track2forcePost.SetAuthCode(auth_code);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(track2forcePost);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.5.1 Encrypted Mag Swipe Force Post
The Encrypted Mag Swipe Force Post is used when a merchant obtains the authorization number directly
from the issuer using a phone or any third-party authorization method. This transaction does not
require that an existing order be logged in the Moneris Gateway. However, the credit card must be
swiped or keyed in using a Moneris-provided encrypted mag swipe reader, and the encrypted Track2
details must be submitted. There are also optional fields that may be submitted such as cust_id and
dynamic_descriptor.
To complete the transaction, the authorization number obtained from the issuer must be entered.
November 2018
Page 136 of 486
Moneris Gateway API - Integration Guide
Encrypted Mag Swipe Force Post transaction object definition
EncTrack2Forcepost enctrack2fp = new EncTrack2Forcepost();
HttpsPostRequest object for Encrypted Mag Swipe Force Post transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(enctrack2fp);
Encrypted Mag Swipe Force Post transaction object values
Table 1 Encrypted Mag Swipe Force Post transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
enctrack2fp.SetOrderId(order_
id);
Amount
String
10-character decimal
enctrack2fp.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Encrypted Track2 data
String
n/a
enctrack2fp.SetEncTrack2(enc_
track2);
POS Code
String
2-character numeric
enctrack2fp.SetPosCode(pos_
code);
Device type
String
30-character alphanumeric
enctrack2fp.SetDeviceType
(device_type);
Authorization Code
String
8-character alphanumeric
enctrack2fp.SetAuthCode(auth_
code);
Page 137 of 486
November 2018
6 Mag Swipe Transaction Set
Table 2 Encrypted Mag Swipe Force Post transaction object optional values
Value
Type
Limits
Set Method
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Customer ID
String
50-character alphanumeric
enctrack2fp.SetCustId(cust_
id);
Dynamic descriptor
String
20-character alphanumeric
enctrack2fp
.SetDynamicDescriptor
(dynamic_descriptor);
Sample Encrypted Mag Swipe Force Post
namespace Moneris
{
using System;
public class TestCanadaEncTrack2Forcepost
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "my customer id";
string amount = "5.00";
string pos_code = "00";
string device_type = "idtech_bdk";
string auth_code = "123456";
string processing_country_code = "CA";
bool status_check = false;
string descriptor = "my descriptor";
string enc_track2 = "ENCRYPTEDTRACK2DATA";
EncTrack2Forcepost enctrack2fp = new EncTrack2Forcepost();
enctrack2fp.SetOrderId(order_id);
enctrack2fp.SetCustId(cust_id);
enctrack2fp.SetAmount(amount);
enctrack2fp.SetEncTrack2(enc_track2);
enctrack2fp.SetPosCode(pos_code);
enctrack2fp.SetDeviceType(device_type);
enctrack2fp.SetAuthCode(auth_code);
enctrack2fp.SetDynamicDescriptor(descriptor);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(enctrack2fp);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
November 2018
Page 138 of 486
Moneris Gateway API - Integration Guide
Sample Encrypted Mag Swipe Force Post
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("MaskedPan = " + receipt.GetMaskedPan());
Console.WriteLine("CardLevelResult = " + receipt.GetCardLevelResult());
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.6 Mag Swipe Purchase Correction
Mag Swipe Purchase Correction transaction object definition
Track2PurchaseCorrection track2void = new Track2PurchaseCorrection();
HttpsPostRequest object for Mag Swipe Purchase Correction transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(track2void);
Mag Swipe Purchase Correction transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 65: Mag Swipe Purchase Correction transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
track2purchasecorrection
.SetOrderId(order_id);
Transaction number
String
255-character alphanumeric
track2purchasecorrection
.SetTxnNumber(txn_number);
Page 139 of 486
November 2018
6 Mag Swipe Transaction Set
Table 66: Mag Swipe Purchase Correction transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
track2purchasecorrection
.SetCustId(cust_id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Sample Mag Swipe Purchase Correction
namespace Moneris
{
using System;
public class TestCanadaTrack2PurchaseCorrection
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string order_id = "Test20150625030621";
string txn_number = "86949-0_10";
string dynamic_descriptor = "123456";
string cust_id = "my customer id";
string processing_country_code = "CA";
bool status_check = false;
Track2PurchaseCorrection track2void = new Track2PurchaseCorrection();
track2void.SetOrderId(order_id);
track2void.SetCustId(cust_id);
track2void.SetTxnNumber(txn_number);
track2void.SetDynamicDescriptor(dynamic_descriptor);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(track2void);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
November 2018
Page 140 of 486
Moneris Gateway API - Integration Guide
Sample Mag Swipe Purchase Correction
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.7 Mag Swipe Refund
Mag Swipe Refund transaction object definition
Track2Refund track2refund = new Track2Refund();
HttpsPostRequest object for Mag Swipe Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(track2refund);
Mag Swipe Refund transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 67: Mag Swipe Refund transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
track2refund.SetOrderId
(order_id);
Amount
String
10-character decimal
track2refund.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Transaction number
Page 141 of 486
String
255-character alphanumeric
track2refund.SetTxnNumber
(txn_number);
November 2018
6 Mag Swipe Transaction Set
Table 68: Mag Swipe Refund transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
track2refund.SetCustId(cust_
id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Dynamic descriptor
String
20-character alphanumeric
track2refund
.SetDynamicDescriptor
(dynamic_descriptor);
Sample Mag Swipe Refund
namespace Moneris
{
using System;
public class TestCanadaTrack2Refund
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string order_id = "Test20150625035152"; //will prompt user for input
string txn_number = "87017-0_10";
string amount = "1.00";
string dynamic_descriptor = "123456";
string cust_id = "customer id";
string processing_country_code = "CA";
bool status_check = false;
Track2Refund track2refund = new Track2Refund();
track2refund.SetOrderId(order_id);
track2refund.SetAmount(amount);
track2refund.SetCustId(cust_id);
track2refund.SetTxnNumber(txn_number);
track2refund.SetDynamicDescriptor(dynamic_descriptor);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(track2refund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
November 2018
Page 142 of 486
Moneris Gateway API - Integration Guide
Sample Mag Swipe Refund
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
6.8 Mag Swipe Independent Refund
NOTE: If you receive a TRANSACTION NOT ALLOWED error, it may mean the Mag
Swipe Independent Refund transaction is not supported on your account. Contact Moneris
to have it temporarily (re-)enabled.
Mag Swipe Independent Refund transaction object definition
Track2IndependentRefund track2indrefund = new Track2IndependentRefund();
HttpsPostRequest object for Mag Swipe Independent Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(track2indrefund);
Page 143 of 486
November 2018
6 Mag Swipe Transaction Set
Mag Swipe Independent Refund transaction values
Table 69: Mag Swipe Independent Refund transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
track2indrefund.SetOrderId
(order_id);
Amount
String
10-character decimal
track2indrefund.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
String
20-character numeric
track2indrefund.SetPan(pan);
Track2 data
String
40-character numeric
track2indrefund.SetTrack2
(track2);
Expiry date
String
4-character alphanumeric
track2indrefund.SetExpdate
(expiry_date);
(YYMM format)
POS code
String
2-character numeric
track2indrefund.SetPosCode
(pos_code);
Table 70: Mag Swipe Independent Refund transaction optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
track2indrefund.SetCustId
(cust_id);
Dynamic descriptor
String
20-character alphanumeric
track2indrefund
.SetDynamicDescriptor(dynamic_
descriptor);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Sample Mag Swipe Independent Refund
namespace Moneris
November 2018
Page 144 of 486
Moneris Gateway API - Integration Guide
Sample Mag Swipe Independent Refund
{
using System;
public class TestCanadaTrack2IndependentRefund
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "Ced_Benson32";
string amount = "5.00";
string track2 = "";
string pan = "4242424242424242";
string exp = "1903"; //must send '0000' if swiped
string pos_code = "00";
string processing_country_code = "CA";
bool status_check = false;
Track2IndependentRefund track2indrefund = new Track2IndependentRefund();
track2indrefund.SetOrderId(order_id);
track2indrefund.SetCustId(cust_id);
track2indrefund.SetAmount(amount);
track2indrefund.SetTrack2(track2);
track2indrefund.SetPan(pan);
track2indrefund.SetExpdate(exp);
track2indrefund.SetPosCode(pos_code);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(track2indrefund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
Page 145 of 486
November 2018
6 Mag Swipe Transaction Set
Sample Mag Swipe Independent Refund
}
}
}
}
6.8.1 Encrypted Mag Swipe Independent Refund
The Encrypted Mag Swipe Independent Refund credits a specified amount to the cardholder’s credit
card. The Encrypted Mag Swipe Independent Refund does not require an existing order to be logged in
the Moneris Gateway. However, the credit card must be swiped using the Moneris-provided encrypted
mag swipe reader to provide the encrypted track2 details.
There are also optional fields that may be submitted such as cust_id and dynamic_descriptor. The
transaction format is almost identical to Encrypted Mag Swipe Purchase and Encrypted Mag Swipe
PreAuth.
NOTE:
The Encrypted Mag Swipe Independent Refund transaction may not be supported on
your account. This may yield a TRANSACTION NOT ALLOWED error when attempting the
transaction.
To temporarily enable (or re-enable) the Independent Refund transaction type, contact
Moneris
Encrypted Mag Swipe Independent Refund transaction object definition
EncTrack2IndependentRefund encindrefund = new EncTrack2IndependentRefund();
HttpsPostRequest object for Encrypted Mag Swipe Independent Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(encindrefund);
November 2018
Page 146 of 486
Moneris Gateway API - Integration Guide
Encrypted Mag Swipe Independent Refund transaction object values
Table 1 Encrypted Mag Swipe Independent Refund transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
encindrefund.SetOrderId
(order_id);
Amount
String
10-character decimal
encindrefund.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Encrypted Track 2 data
String
n/a
encindrefund.SetEncTrack2
(enc_track2);
Device Type
String
30-character alphanumeric
encindrefund.SetDeviceType
(device_type);
POS Code
String
2-character numeric
encindrefund.SetPosCode(pos_
code);
Table 2 Encrypted Mag Swipe Independent Refund transaction object optional values
Value
Type
Limits
Set Method
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Customer ID
String
50-character alphanumeric
encindrefund.SetCustId(cust_
id);
Sample Encrypted Mag Swipe Independent Refund
namespace Moneris
{
using System;
public class TestCanadaEncTrack2IndependentRefund
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "my customer id";
Page 147 of 486
November 2018
6 Mag Swipe Transaction Set
Sample Encrypted Mag Swipe Independent Refund
string amount = "5.00";
string pos_code = "00";
string device_type = "idtech_bdk";
string processing_country_code = "CA";
string enc_track2 = "ENCRYPTEDTRACK2DATA";
string descriptor = "nqa";
EncTrack2IndependentRefund encindrefund = new EncTrack2IndependentRefund();
encindrefund.SetOrderId(order_id);
encindrefund.SetCustId(cust_id);
encindrefund.SetAmount(amount);
encindrefund.SetEncTrack2(enc_track2);
encindrefund.SetPosCode(pos_code);
encindrefund.SetDeviceType(device_type);
encindrefund.SetDynamicDescriptor(descriptor);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(encindrefund);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("MaskedPan = " + receipt.GetMaskedPan());
Console.WriteLine("CardLevelResult = " + receipt.GetCardLevelResult());
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
November 2018
Page 148 of 486
7 Level 2/3 Transactions
l
l
l
l
7.1
7.2
7.3
7.4
About Level 2/3 Transactions
Level 2/3 Visa Transactions
Level 2/3 MasterCard Transactions
Level 2/3 American Express Transactions
7.1 About Level 2/3 Transactions
The Moneris Gateway API supports passing Level 2/3 purchasing card transaction data for
Visa, MasterCard and American Express corporate cards.
All Level 2/3 transactions use the same Pre-Authorization transaction as described in the topic PreAuthorization (page 19).
7.2 Level 2/3 Visa Transactions
l
l
l
l
l
l
l
l
7.2.1
7.2.2
7.2.3
7.2.5
7.2.4
7.2.6
7.2.7
7.2.8
Level 2/3 Transaction Types for Visa
Level 2/3 Transaction Flow for Visa
VS Completion
VS Force Post
VS Purchase Correction
VS Refund
VS Independent Refund
VS Corpais
7.2.1 Level 2/3 Transaction Types for Visa
This transaction set includes a suite of corporate card financial transactions as well as a transaction that
allows for the passing of Level 2/3 data. Please ensure that Visa Level 2/3 support is enabled on your merchant account. Batch Close, Open Totals and Pre-authorization are identical to the transactions outlined
in the section Basic Transaction Set (page 12).
l
l
When the Pre-authorization response contains CorporateCard equal to true then you can submit
the Visa transactions.
If CorporateCard is false then the card does not support Level 2/3 data and non Level 2/3 transaction are to be used. If the card is not a corporate card, please refer to the section 2 Basic Transaction Set for the appropriate non-corporate card transactions.
NOTE: This transaction set is intended for transactions where Corporate Card is true and
Level 2/3 data will be submitted. If the credit card is found to be a corporate card but you do
November 2018
Page 149 of 486
Moneris Gateway API - Integration Guide
not wish to send any Level 2/3 data then you may submit Visa transactions using the basic
transaction set outlined in 2 Basic Transaction Set.
Pre-authorization– (authorization/pre-authorization)
Pre-authorization verifies and locks funds on the customer’s credit card. The funds are locked
for a specified amount of time, based on the card issuer. To retrieve the funds from a preauth
so that they may be settled in the merchant account a capture must be performed. CorporateCard will return as true if the card supports Level 2/3.
VS Completion – (Capture/Pre-authorization Completion)
Once a Pre-authorization is obtained the funds that are locked need to be retrieved from the
customer’s credit card. The capture retrieves the locked funds and readies them for settlement into the merchant account. Prior to performing a VS Completion, a Pre-authorization
must be performed. Once the transaction is completed, VS Corpais must be used to process
the Level 2/3 data.
VS Force Post – (Force Capture/Pre-authorization Completion)
This transaction is an alternative to VS Completion to obtain the funds locked on Pre-auth
obtained from IVR or equivalent terminal. The VS Force Post retrieves the locked funds and
readies them for settlement in to the merchant account. Once the transaction is completed,
VS Corpais must be used to process the Level 2/3 data.
VS Purchase Correction (Void, Correction)
VS Completion and VS Force Post can be voided the same day* that they occur. A
VS Purchase Correction must be for the full amount of the transaction and will remove any
record of it from the cardholder statement.
VS Refund – (Credit)
A VS Refund can be performed against a VS Completion to refund any part or all of the transaction. Once the transaction is completed, VS Corpais must be used to process the Level 2/3
data.
VS Independent Refund – (Credit)
A VS Independent Refund can be performed against a purchase or a capture to refund any
part, or all of the transaction. Independent refund is used when the originating transaction
was not performed through Moneris Gateway. Once the transaction is completed, VS Corpais
must be used to process the Level 2/3 data.
NOTE: the Independent Refund transaction may or may not be supported on your
account. If you receive a transaction not allowed error when attempting an independent refund, it may mean the transaction is not supported on your account. If you
wish to have the Independent Refund transaction type temporarily enabled (or reenabled), please contact the Service Centre at 1-866-319-7450.
VS Corpais – (Level 2/3 Data)
VS Corpais will contain all the required and optional data fields for Level 2/3 Business to Business data. VS Corpais data can be sent when the card has been identified in the Pre-authorization transaction request as being a corporate card.
Page 150 of 486
November 2018
7 Level 2/3 Transactions
* A VS Purchase Correction can be performed against a transaction as long as the batch that contains the
original transaction remains open. When using the automated closing feature, the batch close occurs
daily between 10 – 11 pm EST.
7.2.2 Level 2/3 Transaction Flow for Visa
Pre-authorization/Completion Transaction Flow
Purchase Correction Transaction Flow
7.2.3 VS Completion
Once a Pre-authorization is obtained, the funds that are locked need to be retrieved from the customer’s
credit card. This VS Completion transaction is used to secure the funds locked by a pre-authorization
transaction and readies them for settlement into the merchant account.
NOTE: Once you have completed this transaction successfully, to submit the complete supplemental level 2/3 data, please proceed to VS Corpais.
VS Completion transaction object definition
VsCompletion vsCompletion = new VsCompletion();
HttpsPostRequest object for VS Completion transaction object
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(vsCompletion);
November 2018
Page 151 of 486
Moneris Gateway API - Integration Guide
VS Completion transaction object values
Table 1 VS Completion transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
vsCompletion.SetOrderId
(order_id);
Completion amount
String
10-character decimal
vsCompletion.SetCompAmount
(comp_amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Transaction number
String
255-character alphanumeric
vsCompletion.SetTxnNumber
(txn_number);
E-Commerce Indicator
String
1-character alphanumeric
vsCompletion.SetCryptType
(crypt);
Table 2 Visa - Corporate Card Common Data - Level 2 Request Fields
Req*
Y
Value
National Tax
Limits
12-character decimal
Set Method
vsCompletion
.SetNationalTax
(national_tax);
Description
Must reflect
the amount of
National Tax
(GST or HST)
appearing on
the invoice.
Minimum - 0.01
Maximum 999999.99.
Must have 2
decimal places.
Y
Merchant
VAT Registration/Single
Business Reference
20-character alphanumeric
vsCompletion
.SetMerchantVatNo
(merchant_vat_no);
Merchant’s Tax
Registration
Number
must be
provided if tax
is included on
the invoice
Page 152 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
NOTE: Must
not be all
spaces or all
zeroes
C
Local Tax
12-character decimal
vsCompletion
.SetLocalTax
(local_tax);
Must reflect
the amount of
Local Tax (PST
or QST) appearing on the
invoice
If Local Tax
included then
must not be all
spaces or all zeroes; Must be
provided if
Local Tax (PST
or QST) applies
Minimum =
0.01
Maximum =
999999.99
Must have 2
decimal places
C
Local Tax (PST or QST)
Registration Number
15-character alphanumeric
vsCompletion
.SetLocalTaxNo
(local_tax_no);
Merchant's
Local Tax
(PST/QST) Registration Number
Must be
provided if tax
is included on
the invoice; If
Local Tax
included then
must not be all
spaces or all zeroes
Must be
November 2018
Page 153 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
provided if
Local Tax (PST
or QST) applies
C
Customer
VAT Registration Number
13-character alphanumeric
vsCompletion
.SetCustomerVatNo
(customer_vat_no);
If the Customer’s Tax
Registration
Number
appears on the
invoice to support tax
exempt transactions it must
be provided
here
C
Customer Code/Customer Reference Identifier (CRI)
16-character alphanumeric
vsCompletion
.SetCri(cri);
Value which the
customer may
choose to
provide to the
supplier at the
point of sale –
must be
provided if
given by the
customer
N
Customer Code
17-character alphanumeric
vsCompletion
.SetCustomerCode
(customer_code);
Optional customer code
field that will
not be passed
along to Visa,
but will be
included on
Moneris reporting
N
Invoice Number
17-character alphanumeric
vsCompletion
.SetInvoiceNumber
(invoice_number);
Optional
invoice number
field that will
not be passed
along to Visa,
but will be
included on
Moneris reporting
*Y = Required, N = Optional, C = Conditional
Page 154 of 486
November 2018
7 Level 2/3 Transactions
Sample VS Completion
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestVsCompletion
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="ord-210916-15:14:46";
string comp_amount="5.00";
string txn_number = "19002-0_11";
string crypt="7";
string national_tax = "1.23";
string merchant_vat_no = "gstno111";
string local_tax = "2.34";
string customer_vat_no = "gstno999";
string cri = "CUST-REF-002";
string customer_code="ccvsfp";
string invoice_number="invsfp";
string local_tax_no="ltaxno";
VsCompletion vsCompletion = new VsCompletion();
vsCompletion.SetOrderId(order_id);
vsCompletion.SetCompAmount(comp_amount);
vsCompletion.SetTxnNumber(txn_number);
vsCompletion.SetCryptType(crypt);
vsCompletion.SetNationalTax(national_tax);
vsCompletion.SetMerchantVatNo(merchant_vat_no);
vsCompletion.SetLocalTax(local_tax);
vsCompletion.SetCustomerVatNo(customer_vat_no);
vsCompletion.SetCri(cri);
vsCompletion.SetCustomerCode(customer_code);
vsCompletion.SetInvoiceNumber(invoice_number);
vsCompletion.SetLocalTaxNo(local_tax_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(vsCompletion);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
November 2018
Page 155 of 486
Moneris Gateway API - Integration Guide
Sample VS Completion
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.2.4 VS Purchase Correction
The VS Purchase Correction (also known as a "void") transaction is used to cancel a transaction that was
performed in the current batch. No amount is required because a void is always for 100% of the original
transaction. The only transaction that can be voided using VS Purchase Correction is a VS Completion or
VS Force Post. To send a void the order_id and txn_number from the VS Completion/VS Force Post are
required.
VS Purchase Correction transaction object definition
VsPurchaseCorrection vsPurchaseCorrection = new VsPurchaseCorrection();
HttpsPostRequest object for VS Purchase Correction transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(vsPurchaseCorrection);
VS Purchase Correction transaction object values
Table 1 VS Purchase Correction transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
vsPurchaseCorrection
.SetOrderId(order_id);
Transaction number
String
255-character alphanumeric
vsPurchaseCorrection
.SetTxnNumber(txn_number);
E-Commerce Indicator
String
1-character alphanumeric
vsPurchaseCorrection
.SetCryptType(crypt);
Page 156 of 486
November 2018
7 Level 2/3 Transactions
Sample VS Purchase Correction
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestVsPurchaseCorrection
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test20170116050230";
string txn_number = "39016-0_11";
string crypt="7";
VsPurchaseCorrection vsPurchaseCorrection = new VsPurchaseCorrection();
vsPurchaseCorrection.SetOrderId(order_id);
vsPurchaseCorrection.SetTxnNumber(txn_number);
vsPurchaseCorrection.SetCryptType(crypt);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(vsPurchaseCorrection);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
November 2018
Page 157 of 486
Moneris Gateway API - Integration Guide
7.2.5 VS Force Post
The VS Force Post transaction is used to secure the funds locked by a pre-authorization transaction performed over IVR or equivalent terminal. When sending a force post request, you will need Order ID,
Amount, Credit Card Number, Expiry Date, E-commerce Indicator and the Authorization Code received in
the pre-authorization response.
NOTE: Once you have completed this transaction successfully, to submit the complete supplemental level 2/3 data, please proceed to VS Corpais.
VS Force Post transaction object definition
VsForcePost vsForcePost = new VsForcePost();
HttpsPostRequest object for VS Force Post transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(vsForcePost);
VS Force Post transaction object values
Table 1 VS Force Post transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
vsForcePost.SetOrderId(order_
id);
Amount
String
10-character decimal
vsForcePost.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
Page 158 of 486
String
20-character numeric
vsForcePost.SetPan(pan);
November 2018
7 Level 2/3 Transactions
Value
Type
Expiry Date
String
Limits
4-character numeric
Set Method
vsForcePost.SetExpdate
(expiry_date);
YYMM format
Authorization code
String
8-character alphanumeric
vsForcePost.SetAuthCode(auth_
code);
E-commerce Indicator
String
1-character alphanumeric
vsForcePost.SetCryptType
(crypt);
Table 2 VS Force Post transaction object optional values
Value
Type
Customer ID
String
Limits
50-character alphanumeric
Set Method
vsForcePost.SetCustId(cust_
id);
Table 3 Visa - Corporate Card Common Data - Level 2 Request Fields
Req*
Y
Value
National Tax
Limits
12-character decimal
Set Method
vsForcePost
.SetNationalTax
(national_tax);
Description
Must reflect
the amount of
National Tax
(GST or HST)
appearing on
the invoice.
Minimum 0.01 Maximum
- 999999.99.
Must have 2
decimal places.
Y
Merchant
VAT Registration/Single
Business Reference
20-character alphanumeric
vsForcePost
.SetMerchantVatNo
(merchant_vat_no);
Merchant’s Tax
Registration
Number
must be
provided if tax
is included on
the invoice
NOTE: Must
not be all
spaces or all
November 2018
Page 159 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
zeroes
C
Local Tax
12-character decimal
vsForcePost
.SetLocalTax
(local_tax);
Must reflect
the amount of
Local Tax (PST
or QST) appearing on the
invoice
If Local Tax
included then
must not be all
spaces or all zeroes; Must be
provided if
Local Tax (PST
or QST) applies
Minimum =
0.01
Maximum =
999999.99
Must have 2
decimal places
C
Local Tax (PST or QST)
Registration Number
15-character alphanumeric
vsForcePost
.SetLocalTaxNo
(local_tax_no);
Merchant's
Local Tax
(PST/QST)
Registration
Number
Must be
provided if tax
is included on
the invoice; If
Local Tax
included then
must not be all
spaces or all zeroes
Must be
provided if
Local Tax (PST
Page 160 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
or QST) applies
C
Customer
VAT Registration Number
13-character alphanumeric
vsForcePost
.SetCustomerVatNo
(customer_vat_no);
If the Customer’s Tax
Registration
Number
appears on the
invoice to support tax
exempt transactions it must
be provided
here
C
Customer Code/Customer Reference Identifier (CRI)
16-character alphanumeric
vsForcePost
.SetCri(cri);
Value which
the customer
may choose to
provide to the
supplier at the
point of sale –
must be
provided if
given by the
customer
N
Customer Code
17-character alphanumeric
vsForcePost
.SetCustomerCode
(customer_code);
Optional customer code
field that will
not be passed
along to Visa,
but will be
included on
Moneris reporting
N
Invoice Number
17-character alphanumeric
vsForcePost
.SetInvoiceNumber
(invoice_number);
Optional
invoice number
field that will
not be passed
along to Visa,
but will be
included on
Moneris reporting
*Y = Required, N = Optional, C = Conditional
November 2018
Page 161 of 486
Moneris Gateway API - Integration Guide
Sample VS Force Post
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestVsForcePost
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id="CUST13343";
string amount="5.00";
string pan="4242424254545454";
string expiry_date="2012"; //YYMM
string auth_code="123456";
string crypt="7";
string national_tax = "1.23";
string merchant_vat_no = "gstno111";
string local_tax = "2.34";
string customer_vat_no = "gstno999";
string cri = "CUST-REF-002";
string customer_code="ccvsfp";
string invoice_number="invsfp";
string local_tax_no="ltaxno";
VsForcePost vsForcePost = new VsForcePost();
vsForcePost.SetOrderId(order_id);
vsForcePost.SetCustId(cust_id);
vsForcePost.SetAmount(amount);
vsForcePost.SetPan(pan);
vsForcePost.SetExpDate(expiry_date);
vsForcePost.SetAuthCode(auth_code);
vsForcePost.SetCryptType(crypt);
vsForcePost.SetNationalTax(national_tax);
vsForcePost.SetMerchantVatNo(merchant_vat_no);
vsForcePost.SetLocalTax(local_tax);
vsForcePost.SetCustomerVatNo(customer_vat_no);
vsForcePost.SetCri(cri);
vsForcePost.SetCustomerCode(customer_code);
vsForcePost.SetInvoiceNumber(invoice_number);
vsForcePost.SetLocalTaxNo(local_tax_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(vsForcePost);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Page 162 of 486
November 2018
7 Level 2/3 Transactions
Sample VS Force Post
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.2.6 VS Refund
VS Refund will credit a specified amount to the cardholder’s credit card. A refund can be sent up to the
full value of the original VS Completion or VS Force Post. To send a VS Refund you will require the Order
ID and Transaction Number from the original VS Completion or VS Force Post.
NOTE: Once you have completed this transaction successfully, to submit the complete supplemental level 2/3 data, please proceed to VS Corpais.
VS Refund transaction object definition
VsRefund vsRefund = new VsRefund();
HttpsPostRequest object for VS Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(vsRefund);
November 2018
Page 163 of 486
Moneris Gateway API - Integration Guide
VS Refund transaction object values
Table 1 VS Refund transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
vsRefund.SetOrderId(order_
id);
Transaction number
String
255-character alphanumeric
vsRefund.SetTxnNumber(txn_
number);
Amount
String
10-character decimal
vsRefund.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
E-Commerce Indicator
String
1-character alphanumeric
vsRefund.SetCryptType(crypt);
Table 2 Visa - Corporate Card Common Data - Level 2 Request Fields
Req*
Y
Value
National Tax
Limits
12-character decimal
Set Method
vsRefund
.SetNationalTax
(national_tax);
Description
Must reflect
the amount of
National Tax
(GST or HST)
appearing on
the invoice.
Minimum 0.01 Maximum
- 999999.99.
Must have 2
decimal places.
Y
Merchant
VAT Registration/Single
Business Reference
20-character alphanumeric
vsRefund
.SetMerchantVatNo
(merchant_vat_no);
Merchant’s Tax
Registration
Number
must be
Page 164 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
provided if tax
is included on
the invoice
NOTE: Must
not be all
spaces or all
zeroes
C
Local Tax
12-character decimal
vsRefund
.SetLocalTax
(local_tax);
Must reflect
the amount of
Local Tax (PST
or QST) appearing on the
invoice
If Local Tax
included then
must not be all
spaces or all zeroes; Must be
provided if
Local Tax (PST
or QST) applies
Minimum =
0.01
Maximum =
999999.99
Must have 2
decimal places
C
Local Tax (PST or QST)
Registration Number
15-character alphanumeric
vsRefund
.SetLocalTaxNo
(local_tax_no);
Merchant's
Local Tax
(PST/QST)
Registration
Number
Must be
provided if tax
is included on
the invoice; If
Local Tax
included then
November 2018
Page 165 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
must not be all
spaces or all zeroes
Must be
provided if
Local Tax (PST
or QST) applies
C
Customer
VAT Registration Number
13-character alphanumeric
vsRefund
.SetCustomerVatNo
(customer_vat_no);
If the Customer’s Tax
Registration
Number
appears on the
invoice to support tax
exempt transactions it must
be provided
here
C
Customer Code/Customer Reference Identifier (CRI)
16-character alphanumeric
vsRefund
.SetCri(cri);
Value which
the customer
may choose to
provide to the
supplier at the
point of sale –
must be
provided if
given by the
customer
N
Customer Code
17-character alphanumeric
vsRefund
.SetCustomerCode
(customer_code);
Optional customer code
field that will
not be passed
along to Visa,
but will be
included on
Moneris reporting
N
Invoice Number
17-character alphanumeric
vsRefund
.SetInvoiceNumber
(invoice_number);
Optional
invoice number
field that will
not be passed
along to Visa,
Page 166 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
but will be
included on
Moneris reporting
*Y = Required, N = Optional, C = Conditional
Sample VS Refund
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestVsRefund
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test20170116043144";
string amount="5.00";
string txn_number = "39011-0_11";
string crypt="7";
string national_tax = "1.23";
string merchant_vat_no = "gstno111";
string local_tax = "2.34";
string customer_vat_no = "gstno999";
string cri = "CUST-REF-002";
string customer_code="ccvsfp";
string invoice_number="invsfp";
string local_tax_no="ltaxno";
VsRefund vsRefund = new VsRefund();
vsRefund.SetOrderId(order_id);
vsRefund.SetAmount(amount);
vsRefund.SetTxnNumber(txn_number);
vsRefund.SetCryptType(crypt);
vsRefund.SetNationalTax(national_tax);
vsRefund.SetMerchantVatNo(merchant_vat_no);
vsRefund.SetLocalTax(local_tax);
vsRefund.SetCustomerVatNo(customer_vat_no);
vsRefund.SetCri(cri);
vsRefund.SetCustomerCode(customer_code);
vsRefund.SetInvoiceNumber(invoice_number);
vsRefund.SetLocalTaxNo(local_tax_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(vsRefund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
November 2018
Page 167 of 486
Moneris Gateway API - Integration Guide
Sample VS Refund
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.2.7 VS Independent Refund
VS Independent Refund will credit a specified amount to the cardholder’s credit card. The independent
refund does not require an existing order to be logged in the Moneris Gateway; however, the credit card
number and expiry date will need to be passed. The transaction format is almost identical to a pre-authorization.
NOTE: Once you have completed this transaction successfully, to submit the complete supplemental level 2/3 data, please proceed to VS Corpais.
VS Independent Refund transaction object definition
VsIndependentRefund vsIndependentRefund = new VsIndependentRefund();
HttpsPostRequest object for VS Independent Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(vsIndependentRefund);
Page 168 of 486
November 2018
7 Level 2/3 Transactions
VS Independent Refund transaction object values
Table 1 VS Independent Refund transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
vsIndependentRefund
.SetOrderId(order_id);
Amount
String
10-character decimal
vsIndependentRefund.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
String
20-character numeric
vsIndependentRefund.SetPan
(pan);
Expiry date
String
4-character numeric
vsIndependentRefund
.SetExpdate(expiry_date);
YYMM format
E-commerce indicator
String
1-character alphanumeric
vsIndependentRefund
.SetCryptType(crypt);
Table 2 VS Independent Refund transaction object optional values
Value
Type
Customer ID
String
Limits
50-character alphanumeric
Set Method
vsIndependentRefund.SetCustId
(cust_id);
Table 3 Visa - Corporate Card Common Data - Level 2 Request Fields
Req*
Y
Value
National Tax
Limits
Set Method
Description
12-character decimal
vsIndependentRefund
.SetNationalTax
(national_tax);
Must reflect
the amount of
National Tax
(GST or HST)
appearing on
the invoice.
Minimum 0.01 Maximum
November 2018
Page 169 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
- 999999.99.
Must have 2
decimal places.
Y
Merchant
VAT Registration/Single
Business Reference
20-character alphanumeric
vsIndependentRefund
.SetMerchantVatNo
(merchant_vat_no);
Merchant’s
Tax Registration Number
must be
provided if tax
is included on
the invoice
NOTE: Must
not be all
spaces or all
zeroes
C
Local Tax
12-character decimal
vsIndependentRefund
.SetLocalTax(local_
tax);
Must reflect
the amount of
Local Tax (PST
or QST) appearing on the
invoice
If Local Tax
included then
must not be all
spaces or all
zeroes; Must
be provided if
Local Tax (PST
or QST) applies
Minimum =
0.01
Maximum =
999999.99
Must have 2
decimal places
C
Local Tax (PST or QST)
Registration Number
Page 170 of 486
15-character alphanumeric
vsIndependentRefund
.SetLocalTaxNo
(local_tax_no);
Merchant's
Local Tax
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
(PST/QST)
Registration
Number
Must be
provided if tax
is included on
the invoice; If
Local Tax
included then
must not be all
spaces or all
zeroes
Must be
provided if
Local Tax (PST
or QST) applies
C
Customer
VAT Registration Number
13-character alphanumeric
vsIndependentRefund
.SetCustomerVatNo
(customer_vat_no);
If the Customer’s Tax
Registration
Number
appears on the
invoice to support tax
exempt transactions it must
be provided
here
C
Customer Code/Customer Reference Identifier (CRI)
16-character alphanumeric
vsIndependentRefund
.SetCri(cri);
Value which
the customer
may choose to
provide to the
supplier at the
point of sale –
must be
provided if
given by the
customer
N
Customer Code
17-character alphanumeric
vsIndependentRefund
.SetCustomerCode
(customer_code);
Optional customer code
field that will
not be passed
along to Visa,
November 2018
Page 171 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
but will be
included on
Moneris
reporting
N
Invoice Number
17-character alphanumeric
vsIndependentRefund
.SetInvoiceNumber
(invoice_number);
Optional
invoice number field that
will not be
passed along
to Visa, but will
be included on
Moneris
reporting
*Y = Required, N = Optional, C = Conditional
Sample VS Independent Refund
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestVsIndependentRefund
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id="CUST13343";
string amount="5.00";
string pan="4242424254545454";
string expiry_date="2012"; //YYMM
string crypt="7";
string national_tax = "1.23";
string merchant_vat_no = "gstno111";
string local_tax = "2.34";
string customer_vat_no = "gstno999";
string cri = "CUST-REF-002";
string customer_code="ccvsfp";
string invoice_number="invsfp";
string local_tax_no="ltaxno";
VsIndependentRefund vsIndependentRefund = new VsIndependentRefund();
vsIndependentRefund.SetOrderId(order_id);
vsIndependentRefund.SetCustId(cust_id);
vsIndependentRefund.SetAmount(amount);
vsIndependentRefund.SetPan(pan);
vsIndependentRefund.SetExpDate(expiry_date);
vsIndependentRefund.SetCryptType(crypt);
vsIndependentRefund.SetNationalTax(national_tax);
Page 172 of 486
November 2018
7 Level 2/3 Transactions
Sample VS Independent Refund
vsIndependentRefund.SetMerchantVatNo(merchant_vat_no);
vsIndependentRefund.SetLocalTax(local_tax);
vsIndependentRefund.SetCustomerVatNo(customer_vat_no);
vsIndependentRefund.SetCri(cri);
vsIndependentRefund.SetCustomerCode(customer_code);
vsIndependentRefund.SetInvoiceNumber(invoice_number);
vsIndependentRefund.SetLocalTaxNo(local_tax_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(vsIndependentRefund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.2.8 VS Corpais
VS Corpais will contain all the required and optional data fields for Level 2/3 Purchasing Card Addendum
data. VS Corpais data can be sent when the card has been identified in the Pre-authorization transaction
request as being a corporate card.
In addition to the Order ID and Transaction number, this transaction also contains two objects:
l
l
VS Purcha – Corporate Card Common Data
VS Purchl – Line Item Details
November 2018
Page 173 of 486
Moneris Gateway API - Integration Guide
VS Corpais request must be preceded by a financial transaction (VS Completion, VS Force Post, VS
Refund, VS Independent Refund) and the Corporate Card flag must be set to “true” in the Pre-authorization response.
VS Corpais transaction object definition
VsCorpais vsCorpais = new VsCorpais();
HttpsPostRequest object for VS Corpais transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(vsCorpais);
VS Corpais transaction object values
Table 1 VS Corpais transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
vsCorpais.SetOrderId(order_
id);
Transaction number
String
255-character alphanumeric
vsCorpais.SetTxnNumber(txn_
number);
vsPurcha
Object
n/a
VsPurcha vsPurcha = new
VsPurcha();
vsCorpais.SetVsPurch
(vsPurcha,vsPurchl);
For a list of the variables that appear in
this object, see the
table below
vsPurchl
Object
VsPurchl vsPurchl = new
VsPurchl();
n/a
For a list of the variables that appear in
this object, see the
table below
vsCorpais.SetVsPurch
(vsPurcha,vsPurchl);
*Y = Required, N = Optional, C = Conditional
7.2.8.1 VS Purcha - Corporate Card Common Data
VS Corpais transactions use the VS Purcha object to contain Level 2 data.
Table 1 Corporate Card Common Data - Level 2 Request Fields - VSPurcha
Req*
C
Value
Buyer Name
Page 174 of 486
Limits
30-character
alphanumeric
Set Method
vsPurcha.SetBuyerName
(buyer_name);
Description
Buyer/Recipient
Name
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
NOTE: Name
required by CRA on
transactions >$150
C
Local Tax Rate
4-character
decimal
vsPurchaSetLocalTaxRate
(local_tax_rate);
Indicates the
detailed tax rate
applied in relationship to a local
tax amount
EXAMPLE: 8% PST
should be 8.0
Minimum = 0.01
Maximum = 99.99
NOTE: Must be
provided if Local
Tax (PST or QST)
applies.
N
Duty Amount
9-character
decimal
vsPurchaSetDutyAmount
(duty_amount);
Duty on total purchase amount
A minus sign
means 'amount is a
credit', plus sign or
no sign means
'amount is a debit'
maximum without
sign is 999999.99
N
Invoice Discount
Treatment
1-character
numeric
vsPurcha
.SetDiscountTreatment
(discount_treatment);
Indicates how the
merchant is managing discounts
Must be one of the
following values:
0 - if no invoice level
discounts apply for this
invoice
1 - if Tax was calculated on Post-Discount totals
November 2018
Page 175 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
2 - if Tax was calculated on Pre-Discount
totals
N
Invoice Level Discount Amount
9-character
decimal
vsPurcha.SetDiscountAmt
(discount_amt);
Amount of discount (if provided
at the invoice level
according to the
Invoice Discount
Treatment)
Must be non-zero
if Invoice Discount
Treatment is 1 or 2
Minimum amount
is 0.00 and maximum is 999999.99
C
Ship To Postal
Code / Zip Code
10-character
alphanumeric
vsPurcha
.SetShipToPostalCode
(ship_to_pos_code);
The postal code or
zip code for the
destination where
goods will be
delivered
NOTE: Required if
shipment is
involved
Full alpha postal
code - Valid
ANANAN
format required if
shipping to an
address within
Canada
C
Ship From Postal
Code / Zip Code
10-character
alphanumeric
vsPurcha
.SetShipFromPostalCode
(ship_from_pos_code);
The postal code or
zip code from
which items were
shipped
For Canadian
addresses,requires
full alpha postal
code for the merchant with Valid
ANANAN
Page 176 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
format
C
Destination
Country Code
2-character alphanumeric
vsPurcha.SetDesCouCode
(des_cou_code);
Code of country
where purchased
goods will be
delivered
Use ISO 3166-1
alpha-2 format
NOTE: Required if
it appears on the
invoice for an international transaction
Y
Unique VAT
Invoice Reference Number
25-character
alphanumeric
vsPurcha.SetVatRefNum
(vat_ref_num);
Unique Value
Added Tax Invoice
Reference Number
Must be populated
with the invoice
number and this
cannot be all
spaces or zeroes
Y
Tax Treatment
1-character alphanumeric
vsPurcha
.SetTaxTreatment(tax_
treatment);
Must be one of the
following values:
0 = Net Prices with tax
calculated at line item
level;
1 = Net Prices with tax
calculated at invoice
level;
2 = Gross prices given
with tax information
provided at line item
level;
3 = Gross prices given
with tax information
provided at invoice
level;
4 = No tax applies
(small merchant) on
the invoice for the
transaction
November 2018
Page 177 of 486
Moneris Gateway API - Integration Guide
Req*
N
Value
Freight/Shipping
Amount (Ship
Amount)
Limits
9-character
decimal
Set Method
vsPurcha
.SetFreightAmount
(freight_amount);
Description
Freight charges on
total purchase
If shipping is not
provided as a line
item it must be
provided here, if
applicable
Signed monetary
amount:
Minus (-) sign
means 'amount is a
credit',
Plus (+) sign or no
sign means
'amount is a debit'
Maximum without
sign is 999999.99
C
GST HST Freight
Rate
4-character
decimal
vsPurcha
.SetGstHstFreightRate
(gst_hst_freight_rate);
Rate of GST
(excludes PST) or
HST charged on the
shipping amount
(in accordance with
the Tax Treatment)
If Freight/Shipping
Amount is
provided then this
(National GST or
HST) tax rate must
be provided.
Monetary amount,
maximum is 99.99.
Such as 13% HST is
13.00
C
GST HST Freight
Amount
9-character
decimal
vsPurcha
.SetGstHstFreightAmount
(gst_hst_freight_
amount);
Amount of GST
(excludes PST) or
HST charged on the
shipping amount
If Freight/Shipping
Amount is
Page 178 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
provided then this
(National GST or
HST) tax amount
must be provided if
taxTreatment is 0
or 2
Signed monetary
amount: maximum
without sign is
999999.99.
7.2.8.2 VS Purchl - Line Item Details
VS Corpais transactions use the VS Purchl object to contain Level 3 data.
Line Item Details for VS Purchl
string[] item_com_code = {"X3101", "X84802"};
string[] product_code = {"CHR123", "DDSK200"};
string[] item_description = {"Office Chair", "Disk Drive"};
string[] item_quantity = {"3", "1"};
string[] item_uom = {"EA", "EA"};
string[] unit_cost = {"0.20", "0.40"};
string[] vat_tax_amt = {"0.00", "0.00"};
string[] vat_tax_rate = {"13.00", "13.00"};
string[] discount_treatmentL = {"0", "0"};
string[] discount_amtL = {"0.00", "0.00"};
Setting VS Purchl Line Item Details
vsPurchl.SetVsPurchl(item_com_code[0], product_code[0], item_description[0],
item_quantity[0], item_uom[0], unit_cost[0], vat_tax_amt[0], vat_tax_rate[0],
discount_treatmentL[0], discount_amtL[0]);
vsPurchl.SetVsPurchl(item_com_code[1], product_code[1], item_description[1],
item_quantity[1], item_uom[1], unit_cost[1], vat_tax_amt[1], vat_tax_rate[1],
discount_treatmentL[1], discount_amtL[1]);
November 2018
Page 179 of 486
Moneris Gateway API - Integration Guide
Table 1 Corporate Card Common Data - Level 3 Request Fields - VSPurchl
Req*
Value
Limits
Variable/Field
Description
C
Item Commodity
Code
12-character alphanumeric
item_com_code
Line item Comodity Code (if this
field is not sent,
then Product Code
must be sent)
Y
Product Code
12-character alphanumeric
product_code
Product code for
this line item – merchant’s product
code, manufacturer’s
product code or
buyer’s product
code
Typically this will
be the SKU or identifier by which the
merchant tracks
and prices the item
or service
This should always
be provided for
every line item
Y
Item Description
35-character alphanumeric
item_description
Line item description
Y
Item Quantity
12-character decimal
item_quantity
Quantity invoiced
for this line item
Up to 4 decimal
places supported,
whole numbers
are accepted
Minimum = 0.0001
Maximum =
999999999999
Y
Item Unit of
Measure
Page 180 of 486
2-character alphanumeric
item_uom
Unit of measure
Use ANSI X-12 EDI
Allowable Units of
Measure and
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Variable/Field
Description
Codes
Y
Item Unit Cost
12-character decimal
unit_cost
Line item cost per
unit
2-4 decimal places
accepted
Minimum = 0.0001
Maximum =
999999.9999
N
VAT Tax Amount
12-character decimal
vat_tax_amt
Any value-added
tax or other sales
tax amount
Must have 2
decimal places
Minimum = 0.01
Maximum =
999999.99
N
VAT Tax Rate
4-character decimal
vat_tax_rate
Sales tax rate
EXAMPLE: 8% PST
should be 8.0
maximum 99.99
Y
Discount Treatment
1-character numeric
discount_treatmentL
Must be one of the
following values:
0 if no invoice level discounts apply for this
invoice
1 if Tax was calculated
on Post-Discount totals
2 if Tax was calculated
on Pre-Discount totals
C
Discount
Amount
November 2018
12-character decimal
discount_amtL
Amount of discount, if provided
for this line item
according to the
Line Item Discount
Page 181 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable/Field
Description
Treatment
Must be non-zero
if Line Item Discount Treatment is
1 or 2
Must have 2
decimal places
Minimum = 0.01
Maximum =
999999.99
7.2.8.3 Sample Code for VS Corpais
Sample VS Corpais
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestVsCorpais
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="ord-160916-15:31:39";
string txn_number="18306-0_11";
string buyer_name = "Buyer Manager";
string local_tax_rate = "13.00";
string duty_amount = "0.00";
string discount_treatment = "0";
string discount_amt = "0.00";
string freight_amount = "0.20";
string ship_to_pos_code = "M8X 2W8";
string ship_from_pos_code = "M1K 2Y7";
string des_cou_code = "CAN";
string vat_ref_num = "VAT12345";
string tax_treatment = "3";//3 = Gross prices given with tax information provided at invoice level
string gst_hst_freight_amount = "0.00";
string gst_hst_freight_rate = "13.00";
string[] item_com_code = {"X3101", "X84802"};
string[] product_code = {"CHR123", "DDSK200"};
string[] item_description = {"Office Chair", "Disk Drive"};
string[] item_quantity = {"3", "1"};
string[] item_uom = {"EA", "EA"};
string[] unit_cost = {"0.20", "0.40"};
Page 182 of 486
November 2018
7 Level 2/3 Transactions
Sample VS Corpais
string[] vat_tax_amt = {"0.00", "0.00"};
string[] vat_tax_rate = {"13.00", "13.00"};
string[] discount_treatmentL = {"0", "0"};
string[] discount_amtL = {"0.00", "0.00"};
//Create and set VsPurcha
VsPurcha vsPurcha = new VsPurcha();
vsPurcha.SetBuyerName(buyer_name);
vsPurcha.SetLocalTaxRate(local_tax_rate);
vsPurcha.SetDutyAmount(duty_amount);
vsPurcha.SetDiscountTreatment(discount_treatment);
vsPurcha.SetDiscountAmt(discount_amt);
vsPurcha.SetFreightAmount(freight_amount);
vsPurcha.SetShipToPostalCode(ship_to_pos_code);
vsPurcha.SetShipFromPostalCode(ship_from_pos_code);
vsPurcha.SetDesCouCode(des_cou_code);
vsPurcha.SetVatRefNum(vat_ref_num);
vsPurcha.SetTaxTreatment(tax_treatment);
vsPurcha.SetGstHstFreightAmount(gst_hst_freight_amount);
vsPurcha.SetGstHstFreightRate(gst_hst_freight_rate);
//Create and set VsPurchl
VsPurchl vsPurchl = new VsPurchl();
vsPurchl.SetVsPurchl(item_com_code[0], product_code[0], item_description[0], item_quantity[0],
item_uom[0], unit_cost[0], vat_tax_amt[0], vat_tax_rate[0], discount_treatmentL[0], discount_amtL
[0]);
vsPurchl.SetVsPurchl(item_com_code[1], product_code[1], item_description[1], item_quantity[1],
item_uom[1], unit_cost[1], vat_tax_amt[1], vat_tax_rate[1], discount_treatmentL[1], discount_amtL
[1]);
VsCorpais vsCorpais = new VsCorpais();
vsCorpais.SetOrderId(order_id);
vsCorpais.SetTxnNumber(txn_number);
vsCorpais.SetVsPurch(vsPurcha, vsPurchl);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(vsCorpais);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
November 2018
Page 183 of 486
Moneris Gateway API - Integration Guide
Sample VS Corpais
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.3 Level 2/3 MasterCard Transactions
l
l
l
l
l
l
l
l
7.3.1
7.3.2
7.3.3
7.3.4
7.3.5
7.3.6
7.3.7
7.3.8
Level 2/3 Transaction Types for MasterCard
Level 2/3 Transaction Flow for MasterCard
MC Completion
MC Force Post
MC Purchase Correction
MC Refund
MC Independent Refund
MC Corpais - Corporate Card Common Data with Line Item Details
7.3.1 Level 2/3 Transaction Types for MasterCard
This transaction set includes a suite of corporate card financial transactions as well as a transaction that
allows for the passing of Level 2/3 data. Please ensure MC Level 2/3 processing support is enabled on
your merchant account. Batch Close, Open Totals and Pre-authorization are identical to the transactions
outlined in the section Basic Transaction Set (page 12).
When the Preauth response contains CorporateCard equal to true then you can submit the MC transactions.
If CorporateCard is false then the card does not support Level 2/3 data and non Level 2/3 transaction are
to be used. If the card is not a corporate card, please refer to section 4 for the appropriate non-corporate
card transactions.
NOTE: This transaction set is intended for transactions where Corporate Card is true and
Level 2/3 data will be submitted. If the credit card is found to be a corporate card but you do
not wish to send any Level 2/3 data then you may submit MC transactions using the transaction set outlined in Basic Transaction Set (page 12).
Page 184 of 486
November 2018
7 Level 2/3 Transactions
Pre-auth – (authorization/pre-authorization)
The pre-auth verifies and locks funds on the customer’s credit card. The funds are locked for a
specified amount of time, based on the card issuer. To retrieve the funds from a pre-auth so
that they may be settled in the merchant account a capture must be performed. Level 2/3
data submission is not supported as part of a pre-auth as a pre-auth is not settled. When CorporateCard is returned true then Level 2/3 data may be submitted.
MC Completion – (Capture/Preauth Completion)
Once a Pre-authorization is obtained the funds that are locked need to be retrieved from the
customer’s credit card. The capture retrieves the locked funds and readies them for settlement in to the merchant account. Prior to performing an MCCompletion a Pre-auth must
be performed.
MC Force Post – (Force Capture/Preauth Completion)
This transaction is an alternative to MC Completion to obtain the funds locked on Preauth
obtained from IVR or equivalent terminal. The MC Force Post requires that the original Preauthorization’s auth code is provided and it retrieves the locked funds and readies them for
settlement in to the merchant account.
MC Purchase Correction – (Void, Correction)
MC Completions can be voided the same day* that they occur. A void must be for the full
amount of the transaction and will remove any record of it from the cardholder statement. *
An MC Purchase Correction can be performed against a transaction as long as the batch that
contains the original transaction remains open. When using the automated closing feature
batch close occurs daily between 10 – 11 pm EST.
MC Refund – (Credit)
A MC Refund can be performed against an MC Completion or MC Force Post to refund an
amount less than or equal to the amount of the original transaction.
MC Independent Refund – (Credit)
A MC Indpendent Refund can be performed against an completion to refund any part, or all
of the transaction. Independent refund is used when the originating transaction was not performed through Moneris Gateway. Please note, the MC Independent Refund transaction
may or may not be supported on your account. If you receive a transaction not allowed error
when attempting an MC Independent Refund, it may mean the transaction is not supported
on your account. If you wish to have the MC Independent Refund transaction type temporarily enabled (or re-enabled), please contact the Service Centre at 1-866-319-7450.
MC Corpais Common Line Item – (Level 2/3 Data)
MC Corpais Common Line Item will contain the entire required and optional data field for
Level 2/3 data. MCCorpais Common Line Item data can be sent when the card has been identified in the transaction request as being a corporate card. This transaction supports multiple
data types and combinations:
l
November 2018
Purchasing Card Data:
l Corporate card common data with Line Item Details
Page 185 of 486
Moneris Gateway API - Integration Guide
7.3.2 Level 2/3 Transaction Flow for MasterCard
Pre-authorization/Completion Transaction Flow
Purchase Correction Transaction Flow
7.3.3 MC Completion
The MC Completion transaction is used to secure the funds locked by a pre-authorization transaction.
When sending a capture request you will need two pieces of information from the original pre-authorization– the Order ID and the transaction number from the returned response.
Once you have completed this transaction successfully, to submit the complete supplemental level 2/3 data, please proceed to MC Corpais.
MC Completion transaction object definition
McCompletion mcCompletion = new McCompletion();
HttpsPostRequest object for MC Completion transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(mcCompletion);
Page 186 of 486
November 2018
7 Level 2/3 Transactions
MC Completion transaction object values
Table 1 MC Completion transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
mcCompletion.SetOrderId
(order_id);
Completion amount
String
10-character decimal
mcCompletion.SetCompAmount
(comp_amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Transaction number
String
255-character alphanumeric
mcCompletion.SetTxnNumber
(txn_number);
Merchant reference
number
String
19-character alphanumeric
mcCompletion.SetMerchantRefNo
(merchant_ref_no);
E-commerce indicator
String
1-character alphanumeric
mcCompletion.SetCryptType
(crypt);
Sample MC Completion
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestMcCompletion
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test20170112020548";
string comp_amount="5.00";
string txn_number="660117311792017012140548199-0_11";
string crypt="7";
string merchant_ref_no = "319038";
McCompletion mcCompletion = new McCompletion();
mcCompletion.SetOrderId(order_id);
November 2018
Page 187 of 486
Moneris Gateway API - Integration Guide
Sample MC Completion
mcCompletion.SetCompAmount(comp_amount);
mcCompletion.SetTxnNumber(txn_number);
mcCompletion.SetCryptType(crypt);
mcCompletion.SetMerchantRefNo(merchant_ref_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(mcCompletion);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.3.4 MC Force Post
MC Force Post transaction is used to secure the funds locked by a pre-authorization transaction performed over IVR or equivalent terminal`. When sending a force post request, you will need order_id,
amount, pan (card number), expiry date, crypt type and the authorization code received in the preauthorization response.
MC Force Post transaction object definition
McForcePost mcforcepost= new McForcePost();
Page 188 of 486
November 2018
7 Level 2/3 Transactions
HttpsPostRequest object for MC Force Post transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(mcforcepost);
MC Force Post transaction object values
Table 1 MC Force Post transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
mcforcepost.SetOrderId(order_
id);
Amount
String
10-character decimal
mcforcepost.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
String
20-character alphanumeric
mcforcepost.SetPan(pan);
Expiry date
String
4-character alphanumeric
mcforcepost.SetExpdate
(expiry_date);
(YYMM format)
Authorization code
String
8-character alphanumeric
mcforcepost.SetAuthCode(auth_
code);
E-commerce indicator
String
1-character alphanumeric
mcforcepost.SetCryptType
(crypt);
Merchant reference
number
String
19-character alphanumeric
mcforcepost.SetMerchantRefNo
(merchant_ref_no);
Table 2 MC Force Post transaction object optional values
Value
Customer ID
November 2018
Type
String
Limits
50-character alphanumeric
Set Method
mcforcepost.SetCustId(cust_
id);
Page 189 of 486
Moneris Gateway API - Integration Guide
Sample MC Force Post
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestMcForcePost
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "CUST13343";
string amount = "5.00";
string pan = "5454545442424242";
string expiry_date = "1912"; //YYMM
string auth_code = "123456";
string crypt = "7";
string merchant_ref_no = "319038";
McForcePost mcforcepost = new McForcePost();
mcforcepost.SetOrderId(order_id);
mcforcepost.SetCustId(cust_id);
mcforcepost.SetAmount(amount);
mcforcepost.SetPan(pan);
mcforcepost.SetExpDate(expiry_date);
mcforcepost.SetAuthCode(auth_code);
mcforcepost.SetCryptType(crypt);
mcforcepost.SetMerchantRefNo(merchant_ref_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(mcforcepost);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Page 190 of 486
November 2018
7 Level 2/3 Transactions
Sample MC Force Post
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.3.5 MC Purchase Correction
The MC Purchase Correction (void) transaction is used to cancel a transaction that was performed in the
current batch. No amount is required because a void is always for 100% of the original transaction. The
only transaction that can be voided is completion. To send a void, the Order ID and Transaction Number
from the MC Completion or MC Force Post are required.
MC Purchase Correction transaction object definition
McPurchaseCorrection mcpurchasecorrection = new McPurchaseCorrection();
HttpsPostRequest object for MC Purchase Correction transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(mcpurchasecorrection);
MC Purchase Correction transaction object values
Table 1 MC Purchase Correction transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
mcpurchasecorrection
.SetOrderId(order_id);
Transaction number
String
255-character alphanumeric
mcpurchasecorrection
.SetTxnNumber(txn_number);
E-commerce indicator
String
1-character alphanumeric
mcpurchasecorrection
.SetCryptType(crypt);
November 2018
Page 191 of 486
Moneris Gateway API - Integration Guide
Sample MC Purchase Correction
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestMcPurchaseCorrection
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test20170112020548";
string txn_number="660117311792017012140548199-0_11";
string crypt="7";
McPurchaseCorrection mcpurchasecorrection = new McPurchaseCorrection();
mcpurchasecorrection.SetOrderId(order_id);
mcpurchasecorrection.SetTxnNumber(txn_number);
mcpurchasecorrection.SetCryptType(crypt);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(mcpurchasecorrection);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
Page 192 of 486
November 2018
7 Level 2/3 Transactions
7.3.6 MC Refund
The MC Refund will credit a specified amount to the cardholder’s credit card. A refund can be sent up to
the full value of the original capture. To send a refund you will require the Order ID and Transaction Number from the original MC Completion or MC Force Post.
MC Refund transaction object definition
McRefund mcRefund = new McRefund();
HttpsPostRequest object for MC Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(mcRefund);
MC Refund transaction object values
Table 1 MC Refund transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
mcRefund.SetOrderId(order_
id);
Amount
String
10-character decimal
mcRefund.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Transaction number
String
255-character alphanumeric
mcRefund.SetTxnNumber(txn_
number);
E-commerce indicator
String
1-character alphanumeric
mcRefund.SetCryptType(crypt);
Merchant reference
number
String
19-character alphanumeric
mcRefund.SetMerchantRefNo
(merchant_ref_no);
November 2018
Page 193 of 486
Moneris Gateway API - Integration Guide
Sample MC Refund
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestMcRefund
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test20170112020548";
string amount="5.00";
string txn_number="660117311792017012140548199-0_11";
string crypt="7";
string merchant_ref_no = "319038";
McRefund mcRefund = new McRefund();
mcRefund.SetOrderId(order_id);
mcRefund.SetAmount(amount);
mcRefund.SetTxnNumber(txn_number);
mcRefund.SetCryptType(crypt);
mcRefund.SetMerchantRefNo(merchant_ref_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(mcRefund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
Page 194 of 486
November 2018
7 Level 2/3 Transactions
Sample MC Refund
}
}
}
7.3.7 MC Independent Refund
MC Independent Refund is used when the originating transaction was not performed through Moneris
Gateway and does not require an existing order to be logged in the Moneris Gateway; however, the
credit card number and the expiry date will need to be passed. The transaction format is almost identical
to a purchase or a pre-authorization.
NOTE: Independent refund transactions are not supported on all accounts. If you receive a
transaction not allowed error when attempting an independent refund transaction, it may
mean the feature is not supported on your account. To have Independent Refund transaction functionality temporarily enabled (or re-enabled), please contact the MonerisCustomer Service Centre at 1-866-319-7450.
Once you have completed this transaction successfully, to submit the complete supplemental level 2/3 data, please proceed to MC Corpais.
MC Independent Refund transaction object definition
McIndependentRefund mcindrefund = new McIndependentRefund();
HttpsPostRequest object for MC Independent Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(mcindrefund);
November 2018
Page 195 of 486
Moneris Gateway API - Integration Guide
MC Independent Refund transaction object values
Table 1 MC Independent Refund transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
mcindrefund.SetOrderId(order_
id);
Amount
String
10-character decimal
mcindrefund.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
E-commerce indicator
String
1-character alphanumeric
mcindrefund.SetCryptType
(crypt);
Credit card number
String
20-character numeric
mcindrefund.SetPan(pan);
Expiry date
String
4-character numeric
mcindrefund.SetExpdate
(expiry_date);
(YYMM format)
Merchant reference
number
String
19-character alphanumeric
mcindrefund.SetMerchantRefNo
(merchant_ref_no);
Table 2 MC Independent Refund transaction object optional values
Value
Customer ID
Type
String
Limits
50-character alphanumeric
Set Method
mcindrefund.SetCustId(cust_
id);
Sample MC Independent Refund
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestMcIndependentRefund
{
public static void Main(string[] args)
Page 196 of 486
November 2018
7 Level 2/3 Transactions
Sample MC Independent Refund
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "CUST13343";
string amount = "5.00";
string pan = "5454545442424242";
string expiry_date = "1912"; //YYMM
string crypt = "7";
string merchant_ref_no = "319038";
McIndependentRefund mcindrefund = new McIndependentRefund();
mcindrefund.SetOrderId(order_id);
mcindrefund.SetCustId(cust_id);
mcindrefund.SetAmount(amount);
mcindrefund.SetPan(pan);
mcindrefund.SetExpDate(expiry_date);
mcindrefund.SetCryptType(crypt);
mcindrefund.SetMerchantRefNo(merchant_ref_no);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(mcindrefund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
November 2018
Page 197 of 486
Moneris Gateway API - Integration Guide
7.3.8 MC Corpais - Corporate Card Common Data with Line Item Details
This transaction example includes the following elements for Level 2 and 3 purchasing card corporate
card data processing:
l
l
Corporate Card Common Data (MC Corpac)
l only 1 set of MC Corpac fields can be submitted
l this data set includes data elements that apply to the overall order, e.g., the total overall
taxes
Line Item Details (MC Corpal)
l 1-998 counts of MC Corpal line items can be submitted
l This data set includes the details about each individual item or service purchased
The MC Corpais request must be preceded by a financial transaction (MC Completion, MC Force Post,
MC Refund, MC Independent Refund) and the Corporate Card flag must be set to “true” in the Preauthorization response. The MC Corpais request will need to contain the Order ID of the financial transaction as well as the Transaction Number.
In addition, MC Corpais has a tax array object that can be sent via the Tax fields in MC Corpac and
MC Corpal. For more about the tax array object, see 7.3.8.3 Tax Array Object - MC Corpais.
For descriptions of the Level 2/3 fields, please see Definition of Request Fields for Level 2/3 - MasterCard
(page 427).
MC Corpais transaction object definition
McCorpais mcCorpais = new McCorpais();
HttpsPostRequest object for MC Corpais transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(mcCorpais);
MC Corpais transaction object values
Table 1 MC Corpais transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
mcCorpais.SetOrderId(order_
id);
Transaction number
String
255-character alphanumeric
mcCorpais.SetTxnNumber(txn_
number);
MCCorpac
Object
n/a
mcCorpac.SetMcCorpac
(mcCorpac);
MC Corpal
Object
n/a
mcCorpais.SetMcCorpal
Page 198 of 486
November 2018
7 Level 2/3 Transactions
Value
Type
Limits
Set Method
(mcCorpal);
*Y = Required, N = Optional, C = Conditional
7.3.8.1 MC Corpac - Corporate Card Common Data
Table 1 Corporate Card Common Data - Level 2 Request Fields - MCCorpac
Req*
Value
Limits
Set Method
Description
N
AustinTetra
Number
15-character alphanumeric
mcCorpac
.SetAustinTetraNumber
(austin_tetra_number);
The Austin-Tetra Number
assigned to the card
acceptor
N
NAICS
Code
15-character alphanumeric
mcCorpac.SetNaicsCode
(naics_code);
North American Industry
Classification System
(NAICS) code assigned to
the card acceptor
N
Customer
Code
25-character alphanumeric
mcCorpac.SetCustomerCode1
(customer_code1_c);
A control number, such as
purchase order number,
project number, department allocation number or
name that the purchaser
supplied the merchant
Left-justified; may be
spaces
N
Unique
Invoice
Number
17-character alphanumeric
mcCorpac
.SetUniqueInvoiceNumber
(unique_invoice_number_c);
Unique number associated
with the individual transaction provided by the merchant
N
Commodity
Code
15-character alphanumeric
mcCorpac.SetCommodityCode
(commodity_code);
Code assigned by the merchant that best categorizes
the item(s) being purchased
N
Order
Date
6-character
numeric
mcCorpac.SetOrderDate
(order_date_c);
The date the item was
ordered
YYMMDD
format
November 2018
NOTE: If present, must con-
Page 199 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
tain a valid date
N
Corporation
VAT Number
20-character alphanumeric
mcCorpac
.SetCorporationVatNumber
(corporation_vat_number_c);
Contains a corporation’s
value added tax (VAT) number
N
Customer
VAT Number
20-character alphanumeric
mcCorpac
.SetCustomerVatNumber
(customer_vat_number_c);
Contains the VAT number
for the customer / cardholder used to identify the
customer when purchasing
goods and services from
the merchant
N
Freight
Amount
12-character
decimal
mcCorpac.SetFreightAmount1
(freight_amount_c);
The freight on the total purchase
Must have 2 decimals
Minimum = 0.00 Maximum
= 999999.99
N
Duty
Amount
12-character
decimal
mcCorpac.SetDutyAmount1
(duty_amount_c);
The duty on the total purchase
Must have 2 decimals
Minimum = 0.00
Maximum = 999999.99
N
Destination
State /
Province
Code
3-character
alphanumeric
mcCorpac
.SetDestinationProvinceCode
(destination_province_
code);
State or Province of the
country where the goods
will be delivered
Left justified with trailing
spaces
EXAMPLE: ONT = Ontario
N
Destination
Country
Code
Page 200 of 486
3-character
alphanumeric
ISO 3166-1
mcCorpac
.SetDestinationCountryCode
(destination_country_code);
The country code where
goods will be delivered
Left justified with trailing
spaces
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
alpha-3
format
Description
ISO 3166-1 alpha-3 format
EXAMPLE: CAN = Canada
N
Ship From
Postal
Code
10-character alphanumeric
mcCorpac.SetShipFromPosCode
(ship_from_pos_code);
ANA NAN
format
N
The postal code or zip code
from which items were
shipped
Full alpha postal code Valid ANANAN
format
mcCorpac.SetShipToPosCode
(ship_to_pos_code_c);
Destination
Postal
Code
10-character alphanumeric
The postal code or zip code
where goods will be
delivered
N
Authorized
Contact
Name
36-character alphanumeric
mcCorpac
.SetAuthorizedContactName
(authorized_contact_name_
c);
Name of an individual or
company contacted for
company authorized purchases
N
Authorized
Contact
Phone
17-character alphanumeric
mcCorpac
.SetAuthorizedContactPhone
(authorized_contact_phone);
Phone number of an individual or company contacted for company
authorized purchases
N
Additional
Card
Acceptor
Data
40-character alphanumeric
mcCorpac
.SetAdditionalCardAcceptorD
ata(additional_card_
acceptor_data);
Information pertaining to
the card acceptor
N
Card
Acceptor
Type
8-character
alphanumeric
mcCorpac
.SetCardAcceptorType(card_
acceptor_type);
Various classifications of
business ownership characteristics
Full alpha postal code Valid ANANAN
format if shipping to an
address within Canada
This field takes 8 characters. Each character represents a different
component, as follows:
November 2018
Page 201 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
1st character represents
‘Business Type’ and contains a code to identify the
specific classification or
type of business:
1. Corporation
2. Not known
3. Individual/Sole Proprietorship
4. Partnership
5. Association/Estate/Trust
6. Tax Exempt Organizations (501C)
7. International Organization
8. Limited Liability Company (LLC)
9. Government Agency
2nd character represents
'Business Owner Type'.
Contains a code to identify
specific characteristics
about the business owner.
1 - No application
classification
2 - Female business
owner
3 - Physically handicapped female
business owner
4 - Physically handicapped male business owner
0 - Unknown
3rd character represents
'Business Certification
Type'. Contains a code to
identify specific characteristics about the busi-
Page 202 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
ness certification type,
such as small business, disadvantaged, or other certification type:
1 - Not certified
2 - Small Business
Administration (SBA)
certification small
business
3 - SBA certification
as small disadvantaged business
4 - Other government or agencyrecognized certification (such as
Minority Supplier
Development Council)
5 - Self-certified small
business
6 - SBA certification
as small and other
government or
agency-recognized
certification
7 - SBA certification
as small disadvantaged business and other
government or
agency-recognized
certification
8 - Other government or agencyrecognized certification and self-certified small business
A - SBA certification
November 2018
Page 203 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
as 8(a)
B - Self-certified
small disadvantaged
business (SDB)
C - SBA certification
as HUBZone
0 - Unknown
4th character represents
'Business Racial/Ethnic
Type'. Contains a code
identifying the racial or ethnic type of the majority
owner of the business.
1 - African American
2 - Asian Pacific
American
3 - Subcontinent
Asian American
4 - Hispanic American
5 - Native American
Indian
6 - Native Hawaiian
7 - Native Alaskan
8 - Caucasian
9 - Other
0 - Unknown
5th character represents
'Business Type Provided
Code'
Y - Business type is
provided.
N - Business type
was not provided.
R - Card acceptor
refused to provide
business type
6th character represents
'Business Owner Type
Page 204 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
Provided Code'
Y - Business owner
type is provided.
N - Business owner
type was not
provided.
R - Card acceptor
refused to provide
business type
7th character represents
'Business Certification Type
Provided Code'
Y - Business certification type is
provided.
N - Business certification type was
not provided.
R - Card acceptor
refused to provide
business type
8th character represents
'Business Racial/Ethnic
Type’
Y - Business
racial/ethnic type is
provided.
N - Business
racial/ethnic type
was not provided.
R - Card acceptor
refused to provide
business racial/ethnic type
N
Card
Acceptor
November 2018
20-character alpha-
mcCorpac
.SetCardAcceptorTaxTd(card_
US federal tax ID number or
value-added tax (VAT) ID
Page 205 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
Tax ID
numeric
acceptor_tax_id_c);
N
Card
Acceptor
Reference
Number
25-character alphanumeric
mcCorpac
.SetCardAcceptorReferenceNu
mber(card_acceptor_
reference_number);
Code that facilitates card
acceptor/corporation communication and record
keeping
N
Card
Acceptor
VAT Number
20-character alphanumeric
mcCorpac
.SetCardAcceptorVatNumber
(card_acceptor_vat_number_
c);
Value added tax (VAT) number for the card acceptor
location
Tax
Up to 6
arrays
C
Used to identify the card
acceptor when collecting
and reporting taxes
mcCorpac.SetTax(tax_c);
Can have up to 6 arrays
containing different tax
details
NOTE: If you use this variable, you must fill in all the
fields of tax array mentioned
below.
7.3.8.2 MC Corpal - Line Item Details
MC Corpal Object - Line Item Details
mcCorpal.SetMcCorpal(customer_code1_l[0], line_item_date_l[0], ship_date_l[0],
order_date1_l[0], medical_services_ship_to_health_industry_number_l[0], contract_number_l[0],medical_services_adjustment_l[0], medical_services_product_
number_qualifier_l[0], product_code1_l[0], item_description_l[0], item_quantity_l[0], unit_cost_l[0], item_unit_measure_l[0], ext_item_amount_l[0], discount_amount_l[0], commodity_code_l[0], type_of_supply_l[0], vat_ref_num_l[0],
tax_l[0]);
Table 1 Line Item Details - Level 3 Request Fields - MC Corpal
Req*
N
Value
Customer Code
Page 206 of 486
Limits
25-character alphanumeric
Variable
customer_code1_l
Description
A control number,
such as purchase
order number, project number,
department alloc-
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Variable
Description
ation number or
name that the purchaser supplied
the merchant
N
Line Item Date
6-character numeric
line_item_date_l
YYMMDD format
The purchase date
of the line item referenced in the
associated Corporate Card Line
Item Detail
Fixed length 6
Numeric, in
YYMMDD format
N
Ship Date
6-character numeric
ship_date_l
YYMMDD format
The date the merchandise was
shipped to the destination
Fixed length 6
Numeric, in
YYMMDD format
N
Order Date
6-character numeric
order_date1_ll
YYMMDD format
The date the item
was ordered
Fixed length 6-character numeric, in
YYMMDD format
Y
Product Code
12-character alphanumeric
product_code1_ll
Line item Product
Code
Contains the nonfuel related
product code of
the individual item
purchased
Y
Item Description
35-character alphanumeric
item_description_ll
Line Item description
Contains the
November 2018
Page 207 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable
Description
description of the
individual item purchased
Y
Item Quantity
12-character alphanumeric
item_quantity_ll
Quantity of line
item
Up to 5 decimal
places supported
Minimum amount
is 0.0 and maximum is
9999999.99999
Y
Unit Cost
12-character decimal
unit_cost_ll
Line item cost per
unit.
Must contain a
minimum of 2
decimal places, up
to 5 decimal places
supported.
Minimum amount
is 0.00001 and maximum is
999999.99999
Y
Item Unit Measure
12-character alphanumeric
item_unit_measure_
ll
The line item unit
of measurement
code
ANSI X-12 EDI
Allowable Units of
Measure and
Codes
Y
Extended Item
Amount
9-character decimal
ext_item_amount_ll
Contains the individual item
amount that is normally calculated as
price multiplied by
quantity
Must contain 2
decimal places
Minimum amount
Page 208 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Variable
Description
is 0.00 and maximum is 999999.99
N
Discount
Amount
9-character decimal
discount_amount_ll
Contains the item
discount amount
Must contain 2
decimal places
Minimum amount
is 0.00 and maximum is 999999.99
N
Commodity
Code
15-character alphanumeric
commodity_code_ll
Code assigned to
the merchant that
best categorizes
the item(s) being
purchased
C
Tax
Up to 6 arrays
tax_l
Can have up to 6
arrays containing
different tax details
–see Tax Array
Request Fields
table below for
each field description
NOTE: If you use
this variable, you
must fill in all the
fields of tax array
mentioned below.
7.3.8.3 Tax Array Object - MC Corpais
The tax array object is used when you use the Tax field of both MC Corpac and MC Corpal. If you use the
tax array object, all of the array fields must be sent.
Setting the tax array differs slightly between the two objects.
Setting tax array for MC Corpac
string[] tax_amount_c = { "1.19", "1.29"};
string[] tax_rate_c = { "6.0", "7.0"};
string[] tax_type_c = { "GST", "PST"};
November 2018
Page 209 of 486
Moneris Gateway API - Integration Guide
string[] tax_id_c = { "gst1298", "pst1298"};
string[] tax_included_in_sales_c = { "Y", "N"};
McTax tax_c = new McTax();
tax_c.SetTax(tax_amount_c[0], tax_rate_c[0], tax_type_c[0], tax_id_c[0], tax_
included_in_sales_c[0]);
Setting tax array for MC Corpal
//Tax Details for Items
string[] tax_amount_l = {"0.52", "1.48"};
string[] tax_rate_l = {"13.0", "13.0"};
string[] tax_type_l = {"HST", "HST"};
string[] tax_id_l = {"hst1298", "hst1298"};
string[] tax_included_in_sales_l = {"Y", "Y"};
McTax[] tax_l = new McTax[2];
tax_l[1].SetTax(tax_amount_l[1], tax_rate_l[1], tax_type_l[1], tax_id_l[1],
tax_included_in_sales_l[1]);
Table 1 MC Corpais Tax Array Request Fields
Req*
Y
Value
Tax Amount
Limits
12-character decimal
Variable
tax_amount_c/tax_
amount_l
Description
Contains detail tax
amount for purchase of goods or
services
Must be 2 decimal
places. Minimum
amount is 0.00 and
maximum is
999999.99
Y
Tax Rate
5-character decimal
tax_rate_c/tax_
rate_l
Contains the
detailed tax rate
applied in relationship to a specific tax amount
EXAMPLE: 5% GST
should be ‘5.0’ or
or 9.975% QST
should be ‘9.975’
Page 210 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Variable
Description
May contain up to
3 decimals, minimum 0.001, maximum up to 9999.9
Y
Tax Type
4-character alphanumeric
tax_type_c/tax_
type_l
Contains tax type,
such as
GST,QST,PST,HST
Y
Tax ID
20-character alphanumeric
tax_id_c/tax_id_l
Provides an identification number
used by the card
acceptor with the
tax authority in
relationship to a
specific tax
amount, such as
GST/HST number
Y
Tax included in
sales indicator
1-character alphanumeric
tax_included_in_
sales_c/tax_
included_in_sales_l
This is the indicator
used to reflect additional tax capture
and reporting
Valid values are:
Y = Tax included in
total purchase amount
N = Tax not included in
total purchase amount
7.3.8.4 Sample Code for MC Corpais
Sample MC Corpais - Corporate Card Common Data with Line Item Details
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestMcCorpaisCommonLineItem
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
November 2018
Page 211 of 486
Moneris Gateway API - Integration Guide
Sample MC Corpais - Corporate Card Common Data with Line Item Details
string order_id="ord-200916-13:29:27";
string txn_number="66011731632016264132927986-0_11";
string customer_code1_c ="CustomerCode123";
string card_acceptor_tax_id_c ="UrTaxId";//Merchant tax id which is mandatory
string corporation_vat_number_c ="cvn123";
string freight_amount_c ="1.23";
string duty_amount_c ="2.34";
string ship_to_pos_code_c ="M1R 1W5";
string order_date_c ="141211";
string customer_vat_number_c ="customervn231";
string unique_invoice_number_c ="uin567";
string authorized_contact_name_c ="John Walker";
//Tax Details
string[] tax_amount_c = { "1.19", "1.29"};
string[] tax_rate_c = { "6.0", "7.0"};
string[] tax_type_c = { "GST", "PST"};
string[] tax_id_c = { "gst1298", "pst1298"};
string[] tax_included_in_sales_c = { "Y", "N"};
//Item Details
string[] customer_code1_l = {"customer code", "customer code2"};
string[] line_item_date_l = {"150114", "150114"};
string[] ship_date_l = {"150120", "150122"};
string[] order_date1_l = {"150114", "150114"};
string[] medical_services_ship_to_health_industry_number_l = {null, null};
string[] contract_number_l = {null, null};
string[] medical_services_adjustment_l = {null, null};
string[] medical_services_product_number_qualifier_l = {null, null};
string[] product_code1_l = {"pc11", "pc12"};
string[] item_description_l = {"Good item", "Better item"};
string[] item_quantity_l = {"4", "5"};
string[] unit_cost_l ={"1.25", "10.00"};
string[] item_unit_measure_l = {"EA", "EA"};
string[] ext_item_amount_l ={"5.00", "50.00"};
string[] discount_amount_l ={"1.00", "50.00"};
string[] commodity_code_l ={"cCode11", "cCode12"};
string[] type_of_supply_l = {null, null};
string[] vat_ref_num_l = {null, null};
//Tax Details for Items
string[] tax_amount_l = {"0.52", "1.48"};
string[] tax_rate_l = {"13.0", "13.0"};
string[] tax_type_l = {"HST", "HST"};
string[] tax_id_l = {"hst1298", "hst1298"};
string[] tax_included_in_sales_l = {"Y", "Y"};
//Create and set Tax for McCorpac
McTax tax_c = new McTax();
tax_c.SetTax(tax_amount_c[0], tax_rate_c[0], tax_type_c[0], tax_id_c[0], tax_included_in_sales_c
[0]);
tax_c.SetTax(tax_amount_c[1], tax_rate_c[1], tax_type_c[1], tax_id_c[1], tax_included_in_sales_c
[1]);
//Create and set McCorpac for common data - only set values that you know
McCorpac mcCorpac = new McCorpac();
mcCorpac.SetCustomerCode1(customer_code1_c);
mcCorpac.SetCardAcceptorTaxTd(card_acceptor_tax_id_c);
mcCorpac.SetCorporationVatNumber(corporation_vat_number_c);
mcCorpac.SetFreightAmount1(freight_amount_c);
mcCorpac.SetDutyAmount1(duty_amount_c);
mcCorpac.SetShipToPosCode(ship_to_pos_code_c);
mcCorpac.SetOrderDate(order_date_c);
Page 212 of 486
November 2018
7 Level 2/3 Transactions
Sample MC Corpais - Corporate Card Common Data with Line Item Details
mcCorpac.SetCustomerVatNumber(customer_vat_number_c);
mcCorpac.SetUniqueInvoiceNumber(unique_invoice_number_c);
mcCorpac.SetAuthorizedContactName(authorized_contact_name_c);
mcCorpac.SetTax(tax_c);
//Create and set Tax for McCorpal
McTax[] tax_l = new McTax[2];
tax_l[0] = new McTax();
tax_l[0].SetTax(tax_amount_l[0], tax_rate_l[0], tax_type_l[0], tax_id_l[0], tax_included_in_sales_
l[0]);
tax_l[1] = new McTax();
tax_l[1].SetTax(tax_amount_l[1], tax_rate_l[1], tax_type_l[1], tax_id_l[1], tax_included_in_sales_
l[1]);
//Create and set McCorpal for each item
McCorpal mcCorpal = new McCorpal();
mcCorpal.SetMcCorpal(customer_code1_l[0], line_item_date_l[0], ship_date_l[0], order_date1_l[0],
medical_services_ship_to_health_industry_number_l[0], contract_number_l[0],
medical_services_adjustment_l[0], medical_services_product_number_qualifier_l[0], product_code1_l
[0], item_description_l[0], item_quantity_l[0],
unit_cost_l[0], item_unit_measure_l[0], ext_item_amount_l[0], discount_amount_l[0], commodity_
code_l[0], type_of_supply_l[0], vat_ref_num_l[0], tax_l[0]);
mcCorpal.SetMcCorpal(customer_code1_l[1], line_item_date_l[1], ship_date_l[1], order_date1_l[1],
medical_services_ship_to_health_industry_number_l[1], contract_number_l[1],
medical_services_adjustment_l[1], medical_services_product_number_qualifier_l[1], product_code1_l
[1], item_description_l[1], item_quantity_l[1],
unit_cost_l[1], item_unit_measure_l[1], ext_item_amount_l[1], discount_amount_l[1], commodity_
code_l[1], type_of_supply_l[1], vat_ref_num_l[1], tax_l[1]);
McCorpais mcCorpais = new McCorpais();
mcCorpais.SetOrderId(order_id);
mcCorpais.SetTxnNumber(txn_number);
mcCorpais.SetMcCorpac(mcCorpac);
mcCorpais.SetMcCorpal(mcCorpal);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(mcCorpais);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
November 2018
Page 213 of 486
Moneris Gateway API - Integration Guide
Sample MC Corpais - Corporate Card Common Data with Line Item Details
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.4 Level 2/3 American Express Transactions
l
l
l
l
l
l
l
7.4.1
7.4.2
7.4.4
7.4.5
7.4.6
7.4.7
7.4.8
Level 2/3 Transaction Types for Amex
Level 2/3 Transaction Flow for Amex
AX Completion
AX Force Post
AX Purchase Correction
AX Refund
AX Independent Refund
7.4.1 Level 2/3 Transaction Types for Amex
This transaction set includes a suite of corporate card financial transactions as well as a transaction that
allows for the passing of Level 2/3 data. Please ensure American Express Level 2/3 processing support is
enabled on your merchant account. Batch Close, Open Totals and Pre-authorization are identical to the
transactions outlined in the section Basic Transaction Set (page 12).
l
l
When the Pre-authorization response contains CorporateCard equal to true then you can submit
the AX transactions.
If CorporateCard is false then the card does not support Level 2/3 data and non Level 2/3 transaction are to be used. If the card is not a corporate card, please refer to 2 Basic Transaction Set for
the appropriate non-corporate card transactions.
NOTE: This transaction set is intended for transactions where Corporate Card is true and
Level 2/3 data will be submitted. If the credit card is found to be a corporate card but you do
not wish to send any Level 2/3 data then you may submit AX transactions using the transaction set outlined in the section Basic Transaction Set (page 12).
Page 214 of 486
November 2018
7 Level 2/3 Transactions
Pre-authorization – (authorization)
The preauth verifies and locks funds on the customer’s credit card. The funds are locked for a
specified amount of time, based on the card issuer. To retrieve the funds from a pre-auth so
that they may be settled in the merchant account a capture must be performed. CorporateCard will return as true if the card supports Level 2/3.
AX Completion – (Capture/Pre-authorization Completion)
Once a Pre-authorization is obtained the funds that are locked need to be retrieved from the
customer’s credit card. The capture retrieves the locked funds and readies them for settlement in to the merchant account. Prior to performing an AXCompletion a Preauth must be
performed.
AX Force Post – (Force Capture/Pre-authorization Completion)
This transaction is an alternative to AX Completion to obtain the funds locked on a Pre-authorization obtained from IVR or equivalent terminal. The capture retrieves the locked funds and
readies them for settlement in to the merchant account.
AX Purchase Correction – (Void, Correction)
AX Completion and AX Force Post can be voided the same day* that they occur. A void must
be for the full amount of the transaction and will remove any record of it from the cardholder
statement. * An AX Purchase Correction can be performed against a transaction as long as
the batch that contains the original transaction remains open. When using the automated
closing feature, the batch close occurs daily between 10 – 11 pm EST.
AX Refund – (Credit)
An AX Refund can be performed against an AX Completion and AX Force Post to refund any
part, or all of the transaction.
AX Independent Refund – (Credit)
An AX Independent Refund can be performed against a purchase or a capture to refund any
part, or all of the transaction. Independent refund is used when the originating transaction
was not performed through Moneris Gateway. Please note, the Independent Refund transaction may or may not be supported on your account. If you receive a transaction not
allowed error when attempting an independent refund, it may mean the transaction is not
supported on your account. If you wish to have the AX Independent Refund transaction type
temporarily enabled (or re-enabled), please contact the Service Centre at 1-866-319-7450.
November 2018
Page 215 of 486
Moneris Gateway API - Integration Guide
7.4.2 Level 2/3 Transaction Flow for Amex
Page 216 of 486
November 2018
7 Level 2/3 Transactions
7.4.3 Level 2/3 Data Objects in Amex
7.4.3.1 About the Level 2/3 Data Objects for Amex
7.4.3.2 Defining the AxLevel23 Object
l
Table 1 Object
l
Table 2 Object
l
Table 3 Object
l
l
7.4.3.1 About the Level 2/3 Data Objects for Amex
Many of the Level 2/3 transaction requests using American Express also include a mandatory data object
called AxLevel23. AxLevel23 is also comprised of other objects, also described in this section.
The Level 2/3 data objects within this section apply to all of the following transactions and are passed as
part of the transaction request for:
AX Completion
AX Force Post
AX Refund
AX Independent Refund
l
l
l
l
Things to Consider:
l
l
Please ensure the addendum data below is complete and accurate.
Please ensure the math on quantities calculations, amounts, discounts, taxes, etc. properly adds up to the overall transaction amount. Incorrect amounts will cause the transaction to be rejected.
7.4.3.2 Defining the AxLevel23 Object
AxLevel23 object definition
AxLevel23 level23 = new AxLevel23();
The AXLevel23 object itself has three objects, Table1, Table2 and Table3, all of which are mandatory.
Table 1 AxLevel23 Object
Req*
Y
Value
Table1
Limits
Object
Set Method
AxTable1 table1 =
new AxTable1();
level23.SetTable1
November 2018
Description
Refer below for further breakdown
and definition of
table1
Page 217 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Set Method
Description
(table1);
Y
Table2
AxTable2 table2 =
new AxTable2();
Object
level23.SetTable2
(table2);
Y
Table3
AxTable3 table3 =
new AxTable3();
Object
level23.SetTable3
(table3);
Refer below for further breakdown
and definition of
table2
Refer below for further breakdown
and definition of
table3
*Y = Required, N = Optional, C = Conditional
Table 1 Object
Table 1 contains the addendum data heading information. Contains information such as identification
elements that uniquely identify an invoice (transaction), the customer name and shipping address.
Table 1 object definition
AxTable1 table1 = new AxTable1();
Table 1 AxLevel23 object - Table 1 object fields
Req*
C
Value
Purchase Order
Number
Limits
22-character alphanumeric
Set Method
table1.SetBig04
(big04);
Description
The cardholder supplied Purchase Order
Number, which is
entered by the merchant at the point-ofsale
This entry is used in
the Statement/Reporting process and may include
accounting information specific to the
client
NOTE: This element
is mandatory, if the
merchant’s customer
provides a Purchase
Order Number.
Page 218 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
N
Release Number
30-character alphanumeric
table1.SetBig05
(big05);
A number that identifies a release
against a Purchase
Order previously
placed by the parties
involved in the transaction
N
Invoice Number
8-character alphanumeric
table1.SetBig10
(big10);
Contains the Amex
invoice/reference
number
N
N1Loop
Object
table1.SetN1Loop
(n1Loop)
Refer below for further breakdown and
definition of N1Loop
object
*Y = Required, N = Optional, C = Conditional
Table 1 also has its own objects:
l
l
N1Loop object
AxRef object
Table 1 - Setting the N1Loop Object
The N1Loop data set contains the Requester names. It can also optionally contain the buying group, ship
from, ship to and receiver details.
A minimum of at least 1 n1Loop must be set. Up to 5 n1Loop can be set.
N1Loop object definition
n1Loop.SetN1Loop(n101, n102, n301, n401, n402, n403, axRef1);
Table 1 AxLevel23 object - Table 1 object - N1Loop object fields
Req*
Y
Value
Entity Identifier
Code
Limits
2-character alphanumeric
Variable or Set Method
n101
Description
Supported values:
R6 - Requester
(required)
BG - Buying Group
(optional)
SF - Ship From
(optional)
ST - Ship To (optional)
November 2018
Page 219 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable or Set Method
Description
40 - Receiver (optional)
Y
Name
40-character alphanumeric
n102
n101
code
n102
meaning
R6
Requester
Name
BG
Buying Group
Name
SF
Ship
From Name
ST
Ship To Name
40
Receiver Name
N
Address
40-character alphanumeric
n301
Address
N
City
30-character alphanumeric
n401
City
N
State or Province
2-character alphanumeric
n402
State or province
N
Postal Code
15-character alphanumeric
n403
Postal Code
N
AxRef
Object
AxRef axRef1 = new
AxRef();
Refer below for further breakdown
and definition of
AxRef object.
This object contains the customer
postal code (mandatory) and customer reference
number (optional)
A minimum of 1
axRef1 must be
set; maximum of 2
axRef1’s may be
set
*Y = Required, N = Optional, C = Conditional
Page 220 of 486
November 2018
7 Level 2/3 Transactions
Table 1 - Setting the AxRef Object
Setting AXRef object
AxRef axRef1 = new AxRef();
string[] ref01 = {"4C", "CR"}; //Reference ID Qualifier
string[] ref02 = {"M5T3A5", "16802309004"}; //Reference ID
axRef1.SetRef(ref01[0], ref02[0]);
axRef1.SetRef(ref01[1], ref02[1]);
Table 1 AxLevel23 object - Table 1 object - AxRef object fields
Req*
Y
Value
Reference
Identification
Qualifier
Limits
2-character alphanumeric
Variable
ref01
Description
This element may contain the following qualifiers for the
corresponding occurrences of the N1Loop:
n101
value
R6
ref01
denotation
Supported values:
4C - Shipment
Destination
Code (mandatory)
CR - Customer
Reference
Number (conditional)
Y
Reference
Identification
November 2018
15-character alphanumeric
ref02
BG
n/a
SF
n/a
ST
n/a
40
n/a
This field must be populated for each ref01
provided
Page 221 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable
Description
ref01 ref02 denotavalue
tion
4C
(n101
value =
R6)
This element must
contain the Amex
Ship-to Postal Code
of the destination
where the commodity was shipped.
If the Ship-to Postal
Code is unavailable,
the postal code of
the merchant location where the
transaction took
place may be substituted.
CR
(n101
value =
R6):
This element must
contain the Amex
Card member Reference Number (e.g.,
purchase order, cost
center, project number, etc.) that corresponds to this
transaction, if
provided by the
Cardholder.
This information
may be displayed in
the statement/reporting process and may include
client-specific
accounting information.
*Y = Required, N = Optional, C = Conditional
Table 2 Object
Table 2 includes the transaction’s addendum detail. It contains transaction data including reference
codes, debit or credit and tax amounts, line item detail descriptions, shipping information and much
more. All transaction data in an invoice relate to a single transaction and cardholder account number.
Table 2 object definition
AxTable2 table2 = new AxTable2();
Page 222 of 486
November 2018
7 Level 2/3 Transactions
Table 1 AxLevel23 object - Table 2 object fields
Req*
N
Value
It1loop
Limits
Set Method
table2.SetIt1Loop
(it1Loop);
Object
Description
Refer below for further breakdown
and definition of
object details.
*Y = Required, N = Optional, C = Conditional
Table 2 - Setting the AxIt1Loop Object
The AxIt1Loop data defines the baseline item data for the invoice. This data is defined for each item/service purchased and included within this invoice. This data set contains basic transaction data, including
quantity, unit of measure, unit price and goods/services reference information.
l
l
A minimum of 1 it1Loop required
A maximum of 999 it1Loop’s supported
AxIt1Loop object definition
AxIt1Loop it1Loop = new AxIt1Loop();
it1Loop.SetIt1Loop(it102[0], it103[0], it104[0], it105[0], it106s[0], txi[0],
pam05[0], pid05[0]);
it1Loop.SetIt1Loop(it102[1], it103[1], it104[1], it105[1], it106s[1], txi[1],
pam05[1], pid05[1]);
Table 1 AxLevel23 object - Table 2 object - AxIt1Loop object fields
Req*
Y
Value
Line Item Quantity Invoiced
Limits
10-character decimal
Variable
it102
Description
Quantity of line
item
Up to 2 decimal
places supported
Minimum amount
is 0.0 and maximum is
9999999999
Y
Unit or Basis for
Measurement
Code
2-character alphanumeric
it103
The line item unit
of measurement
code
Must contain a
November 2018
Page 223 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable
Description
code that specifies
the units in which
the value is
expressed or the
manner in which a
measurement is
taken
EXAMPLE: EA =
each, E5=inches
See ANSI X-12 EDI
Allowable Units of
Measure and
Codes for the list
of codes
Y
Unit Price
15-character decimal
it104
Line item cost per
unit
Must contain 2
decimal places
Minimum amount
is 0.00 and maximum is 999999.99
N
Basis or Unit
Price Code
2-character alphanumeric
it105
Code identifying
the type of unit
price for an item
EXAMPLE: DR =
dealer, AP =
advise price
See ASC X12
004010 Element
639 for list of codes
N
AxIt106s
object
it106s
Refer below for further breakdown
and definition of
object details.
N
AxTxi
object
txi
Refer below for further breakdown
and definition of
Page 224 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Variable
Description
object details
A maximum of 12
AxTxi (tax information data sets)
may be defined
NOTE: that if line
item level tax
information is populated in AxTxi in
Table2, then tax
totals for the
entire invoice
(transaction) must
be entered in
Table3.
Y
Line Item Extended Amount
8-character decimal
pam05
Contains the individual item
amount that is normally calculated as
price multiplied by
quantity
Must contain 2
decimal places
Minimum amount
is 0.00 and maximum is 99999.99
Y
Line Item Description
80-character alphanumeric
pid05
Line Item description
Contains the
description of the
individual item purchased
This field pertain to
each line item in
the transaction
*Y = Required, N = Optional, C = Conditional
November 2018
Page 225 of 486
Moneris Gateway API - Integration Guide
Table 2 - Setting the AxIt106s Object
AxIt106s[] it106s = {new AxIt106s(), new AxIt106s(), new AxIt106s(), new
AxIt106s(), new AxIt106s()};
string[] it10618 = {"MG", "MG", "MG", "MG", "MG"}; //Product/Service ID
qualifier
string[] it10719 = {"DJFR4", "JFJ49", "FEF33", "FEE43", "DISCOUNT"};
//Product/Service ID (corresponds to it10618)
Table 1 AxLevel23 object - Table 2 object - AxIt106s object fields
Req*
N
Value
Product/Service
ID Qualifier
Limits
2-character alphanumeric
Set Method
it106s
[0].SetIt10618
(it10618[0]);
it106s
[1].SetIt10618
(it10618[1]);
Description
Supported values:
MG - Manufacturer’s
Part Number
VC - Supplier Catalog
Number
SK - Supplier Stock
Keeping Unit Number
UP - Universal Product
Code
VP – Vendor Part Number
PO – Purchase Order
Number
AN – Client Defined
Asset Code
N
Product/Service
ID
it10618
VC
it10719 size/type
20-character
alphanumeric
PO
22-character
alphanumeric
Other
30-character
alphanumeric
it106s
[0].SetIt10719
(it10719[0]);
it106s
[1].SetIt10719
(it10719[1]);
Product/Service ID
corresponds to the
preceding qualifier
defined by it10618
The maximum
length depends on
the qualifier
defined in it10618
*Y = Required, N = Optional, C = Conditional
Table 2 - Setting the AxTxi Object
Table 2 AxiTxi object definition
//Create Table 2 with details
string[] txi01_GST = {"GS", "GS", "GS", "GS", "GS"}; //Tax type code
Page 226 of 486
November 2018
7 Level 2/3 Transactions
string[] txi02_GST = {"0.70", "1.75", "1.00", "0.80","0.00"}; //Monetary
amount
string[] txi03_GST = {"5.0", "5.0", "5.0", "5.0","5.0"}; //Percent
string[] txi06_GST = {"", "", "", "",""}; //Tax exempt code
string[] txi01_PST = {"PG", "PG", "PG","PG","PG"}; //Tax type code
string[] txi02_PST = {"0.80", "2.00", "1.00", "0.80","0.00"}; //Monetary
amount
string[] txi03_PST = {"7.0", "7.0", "7.0", "7.0","7.0"}; //Percent
string[] txi06_PST = {"", "", "", "",""}; //Tax exempt code
AxTxi[] txi = {new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi
()};
txi[0].SetTxi(txi01_GST[0], txi02_GST[0], txi03_GST[0], txi06_GST[0]);
txi[0].SetTxi(txi01_PST[0], txi02_PST[0], txi03_PST[0], txi06_PST[0]);
txi[1].SetTxi(txi01_GST[1], txi02_GST[1], txi03_GST[1], txi06_GST[1]);
txi[1].SetTxi(txi01_PST[1], txi02_PST[1], txi03_PST[1], txi06_PST[1]);
txi[2].SetTxi(txi01_GST[2], txi02_GST[2], txi03_GST[2], txi06_GST[2]);
txi[2].SetTxi(txi01_PST[2], txi02_PST[2], txi03_PST[2], txi06_PST[2]);
txi[3].SetTxi(txi01_GST[3], txi02_GST[3], txi03_GST[3], txi06_GST[3]);
txi[3].SetTxi(txi01_PST[3], txi02_PST[3], txi03_PST[3], txi06_PST[3]);
txi[4].SetTxi(txi01_GST[4], txi02_GST[4], txi03_GST[4], txi06_GST[4]);
txi[4].SetTxi(txi01_PST[4], txi02_PST[4], txi03_PST[4], txi06_PST[4]);
Table 1 AxLevel23 object - Table 2 object - AxiTxi object fields
Req*
C
Value
Tax Type code
Limits
txi01
Variable
2-character alphanumeric
Description
Tax type code
applicable to
Canada and US
only
For Canada, this
field must contain
a code that specifies the type of
tax
If txi01 is used,
November 2018
Page 227 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable
Description
then txi02, txi03 or
txi06 must be populated
Valid codes include
the following:
CT – County/Tax
(optional)
CA – City Tax
(optional)
EV – Environmental
Tax (optional)
GS – Good and Services Tax (GST)
(optional)
LS – State and Local
Sales Tax (optional)
LT – Local Sales Tax
(optional)
PG – Provincial Sales
Tax (PST) (optional)
SP – State/Provincial
Tax a.k.a. Quebec
Sales Tax (QST)
(optional)
ST – State Sales Tax
(optional)
TX – All Taxes
(required)
VA – Value-Added Tax
a.k.a. Canadian Harmonized Sales Tax
(HST) (optional)
C
Monetary
Amount
txi02
6-character decimal
This element may
contain the monetary tax amount
that corresponds
to the Tax Type
Code in txi01
NOTE:
If txi02 is used in
mandatory occur-
Page 228 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Variable
Description
rence txi01=TX, txi02
must contain the
total tax amount
applicable to the
entire invoice (transaction)
If taxes are not
applicable for the
entire invoice (transaction), txi02 must
be 0.00.
The maximum
value that can be
entered in this
field is “9999.99”,
which is $9,999.99
(CAD)
A debit is entered
as: 9999.99
A credit is entered
as: –9999.99
C
Percent
txi03
10-character decimal
Contains the tax
percentage (in
decimal format)
that corresponds
to the tax type
code defined in
txi01
Up to 2 decimal
places supported
C
Tax Exempt Code
txi06
1-character alphanumeric
This element may
contain the Tax
Exempt Code that
identifies the
exemption status
from sales and tax
that corresponds
to the Tax Type
Code in txi01
Supported values:
1 – Yes (Tax Exempt)
2 – No (Not Tax
Exempt)
November 2018
Page 229 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable
Description
4 – Not Exempt/For
Resale
A – Labor Taxable,
Material Exempt
B – Material Taxable,
Labor Exempt
C – Not Taxable
F – Exempt (Goods /
Services Tax)
G – Exempt (Provincial
Sales Tax)
L – Exempt Local Service
R – Recurring Exempt
U – Usage Exempt
*Y = Required, N = Optional, C = Conditional
Table 3 Object
Table 3 includes the transaction addendum summary. It contains the total invoice (transaction) amount,
sales tax, freight and/or handling charges and invoice summary information, including total line items,
number of segments in the invoice, and the transaction set control number (a.k.a., batch number).
Table 3 object definition
AxTable3 table3 = new AxTable3();
Table 1 AxLevel23 object - Table 3 object fields
Req*
C
Value
AxTxi
Limits
Object
Set Method
table3.SetTxi
(taxTbl3);
Description
Refer below for further breakdown
and definition of
object details.
NOTE: if line item
level tax information is populated
in AxTxi in Table2,
then tax totals for
the entire invoice
Page 230 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Set Method
Description
(transaction) must
be entered in
Table3. A maximum of 10
AxTxi’s may be set
in Table3.
*Y = Required, N = Optional, C = Conditional
Table 3 - Setting the AxTxi Object
The mandatory tax information data set must contain the total tax amount applicable to the entire
invoice (transaction) which includes all line items identified in Table2. If taxes are not applicable for the
entire invoice (transaction), then txi02 must be set to 0.00.
Tax totals must be entered in this mandatory tax information segment in Table 3, even if line item detail
level tax data is reported in Table 2.
At least one occurrence of txi02, txi03 or txi06 is required.
Table 3 AxiTxi object definition
AxTxi taxTbl3 = new AxTxi();
taxTbl3.SetTxi("GS", "4.25","5.0",""); //sum of GST taxes
taxTbl3.SetTxi("PG", "4.60","7.0",""); //sum of PST taxes
taxTbl3.SetTxi("TX", "8.85","13.0",""); //sum of all taxes
Table 1 AxLevel23 object - Table 3 object - AxiTxi object fields
Req*
C
Value
Tax Type code
Limits
txi01
Variable
2-character alphanumeric
Description
Tax type code
applicable to
Canada and US
only
For Canada, this
field must contain
a code that specifies the type of
tax
If txi01 is used,
then txi02, txi03 or
txi06 must be populated
November 2018
Page 231 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable
Description
Valid codes include
the following:
CT – County/Tax
(optional)
CA – City Tax
(optional)
EV – Environmental
Tax (optional)
GS – Good and Services Tax (GST)
(optional)
LS – State and Local
Sales Tax (optional)
LT – Local Sales Tax
(optional)
PG – Provincial Sales
Tax (PST) (optional)
SP – State/Provincial
Tax a.k.a. Quebec
Sales Tax (QST)
(optional)
ST – State Sales Tax
(optional)
TX – All Taxes
(required)
VA – Value-Added Tax
a.k.a. Canadian Harmonized Sales Tax
(HST) (optional)
C
Monetary
Amount
txi02
6-character decimal
This element may
contain the monetary tax amount
that corresponds
to the Tax Type
Code in txi01
NOTE:
If txi02 is used in
mandatory occurrence txi01=TX, txi02
must contain the
total tax amount
applicable to the
entire invoice (transaction)
Page 232 of 486
November 2018
7 Level 2/3 Transactions
Req*
Value
Limits
Variable
Description
If taxes are not
applicable for the
entire invoice (transaction), txi02 must
be 0.00.
The maximum
value that can be
entered in this
field is “9999.99”,
which is $9,999.99
(CAD)
A debit is entered
as: 9999.99
A credit is entered
as: –9999.99
C
Percent
txi03
10-character decimal
Contains the tax
percentage (in
decimal format)
that corresponds
to the tax type
code defined in
txi01
Up to 2 decimal
places supported
C
Tax Exempt Code
txi06
1-character alphanumeric
This element may
contain the Tax
Exempt Code that
identifies the
exemption status
from sales and tax
that corresponds
to the Tax Type
Code in txi01
Supported values:
1 – Yes (Tax Exempt)
2 – No (Not Tax
Exempt)
4 – Not Exempt/For
Resale
A – Labor Taxable,
Material Exempt
November 2018
Page 233 of 486
Moneris Gateway API - Integration Guide
Req*
Value
Limits
Variable
Description
B – Material Taxable,
Labor Exempt
C – Not Taxable
F – Exempt (Goods /
Services Tax)
G – Exempt (Provincial
Sales Tax)
L – Exempt Local Service
R – Recurring Exempt
U – Usage Exempt
*Y = Required, N = Optional, C = Conditional
7.4.4 AX Completion
The AX Completion transaction is used to secure the funds locked by a pre-authorization transaction.
When sending a capture request you will need two pieces of information from the original pre-authorization – the Order ID and the transaction number from the returned response.
AX Completion transaction object definition
AxCompletion axCompletion = new AxCompletion()
HttpsPostRequest object for AX Completion
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(axCompletion);
Page 234 of 486
November 2018
7 Level 2/3 Transactions
AX Completion transaction object values
Table 1 AX Completion transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
axCompletion.SetOrderId
(order_id);
Completion amount
String
10-character decimal
axCompletion.SetCompAmount
(comp_amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Transaction number
String
255-character alphanumeric
axCompletion.SetTxnNumber
(txn_number);
E-commerce indicator
String
1-character alphanumeric
axCompletion.SetCryptType
(crypt);
Level 2/3 Data
Object
n/a
axCompletion.SetAxLevel23
(level23);
Sample AX Completion
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestAxCompletion
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string
string
string
string
order_id="ord-210916-12:06:38";
comp_amount="62.37";
txn_number = "18924-0_11";
crypt="7";
//Create Table 1 with details
string n101 = "R6"; //Entity ID Code
November 2018
Page 235 of 486
Moneris Gateway API - Integration Guide
Sample AX Completion
string n102 = "Retailing Inc. International"; //Name
string n301 = "919 Oriole Rd."; //Address Line 1
string n401 = "Toronto"; //City
string n402 = "On"; //State or Province
string n403 = "H1T6W3"; //Postal Code
string[] ref01 = {"4C", "CR"}; //Reference ID Qualifier
string[] ref02 = {"M5T3A5", "16802309004"}; //Reference ID
string big04 = "PO7758545"; //Purchase Order Number
string big05 = "RN0049858"; //Release Number
string big10 = "INV99870E"; //Invoice Number
AxRef axRef1 = new AxRef();
axRef1.SetRef(ref01[0], ref02[0]);
axRef1.SetRef(ref01[1], ref02[1]);
AxN1Loop n1Loop = new AxN1Loop();
n1Loop.SetN1Loop(n101, n102, n301, n401, n402, n403, axRef1);
AxTable1 table1 = new AxTable1();
table1.SetBig04(big04);
table1.SetBig05(big05);
table1.SetBig10(big10);
table1.SetN1Loop(n1Loop);
//Create Table 2
//the sum of the
string[] it102 =
string[] it103 =
string[] it104 =
string[] it105 =
with details
extended amount field (pam05) must equal the level 1 amount field
{"1", "1", "1", "1", "1"}; //Line item quantity invoiced
{"EA", "EA", "EA", "EA", "EA"}; //Line item unit or basis of measurement code
{"10.00", "25.00", "8.62", "10.00", "-10.00"}; //Line item unit price
{"", "", "", "", ""}; //Line item basis of unit price code
string[] it10618 = {"MG", "MG", "MG", "MG", "MG"}; //Product/Service ID qualifier
string[] it10719 = {"DJFR4", "JFJ49", "FEF33", "FEE43", "DISCOUNT"}; //Product/Service ID
(corresponds to it10618)
string[]
string[]
string[]
string[]
txi01_GST
txi02_GST
txi03_GST
txi06_GST
=
=
=
=
{"GS", "GS", "GS", "GS", "GS"}; //Tax type code
{"0.70", "1.75", "1.00", "0.80","0.00"}; //Monetary amount
{"", "", "", "",""}; //Percent
{"", "", "", "",""}; //Tax exempt code
string[] txi01_PST = {"PG", "PG", "PG","PG","PG"}; //Tax type code
string[] txi02_PST = {"0.80", "2.00", "1.00", "0.80","0.00"}; //Monetary amount
string[] txi03_PST = {"", "", "", "",""}; //Percent
string[] txi06_PST = {"", "", "", "",""}; //Tax exempt code
string[] pam05 = {"11.50", "28.75", "10.62", "11.50", "-10.00"}; //Extended line-item amount
string[] pid05 = {"Stapler", "Lamp", "Bottled Water", "Fountain Pen", "DISCOUNT"}; //Line item
description
AxIt106s[] it106s = {new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s
()};
it106s[0].SetIt10618(it10618[0]);
it106s[0].SetIt10719(it10719[0]);
it106s[1].SetIt10618(it10618[1]);
it106s[1].SetIt10719(it10719[1]);
it106s[2].SetIt10618(it10618[2]);
it106s[2].SetIt10719(it10719[2]);
it106s[3].SetIt10618(it10618[3]);
it106s[3].SetIt10719(it10719[3]);
Page 236 of 486
November 2018
7 Level 2/3 Transactions
Sample AX Completion
it106s[4].SetIt10618(it10618[4]);
it106s[4].SetIt10719(it10719[4]);
AxTxi[] txi = {new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi()};
txi[0].SetTxi(txi01_GST[0], txi02_GST[0], txi03_GST[0], txi06_GST[0]);
txi[0].SetTxi(txi01_PST[0], txi02_PST[0], txi03_PST[0], txi06_PST[0]);
txi[1].SetTxi(txi01_GST[1], txi02_GST[1], txi03_GST[1], txi06_GST[1]);
txi[1].SetTxi(txi01_PST[1], txi02_PST[1], txi03_PST[1], txi06_PST[1]);
txi[2].SetTxi(txi01_GST[2], txi02_GST[2], txi03_GST[2], txi06_GST[2]);
txi[2].SetTxi(txi01_PST[2], txi02_PST[2], txi03_PST[2], txi06_PST[2]);
txi[3].SetTxi(txi01_GST[3], txi02_GST[3], txi03_GST[3], txi06_GST[3]);
txi[3].SetTxi(txi01_PST[3], txi02_PST[3], txi03_PST[3], txi06_PST[3]);
txi[4].SetTxi(txi01_GST[4], txi02_GST[4], txi03_GST[4], txi06_GST[4]);
txi[4].SetTxi(txi01_PST[4], txi02_PST[4], txi03_PST[4], txi06_PST[4]);
AxIt1Loop it1Loop = new AxIt1Loop();
it1Loop.SetIt1Loop(it102[0], it103[0], it104[0], it105[0], it106s[0], txi[0], pam05[0],
it1Loop.SetIt1Loop(it102[1], it103[1], it104[1], it105[1], it106s[1], txi[1], pam05[1],
it1Loop.SetIt1Loop(it102[2], it103[2], it104[2], it105[2], it106s[2], txi[2], pam05[2],
it1Loop.SetIt1Loop(it102[3], it103[3], it104[3], it105[3], it106s[3], txi[3], pam05[3],
it1Loop.SetIt1Loop(it102[4], it103[4], it104[4], it105[4], it106s[4], txi[4], pam05[4],
AxTable2 table2 = new AxTable2();
table2.SetIt1Loop(it1Loop);
//Create Table 3 with details
AxTxi taxTbl3 = new AxTxi();
taxTbl3.SetTxi("GS", "4.25","",""); //sum of GST taxes
taxTbl3.SetTxi("PG", "4.60","",""); //sum of PST taxes
taxTbl3.SetTxi("TX", "8.85","",""); //sum of all taxes
AxTable3 table3 = new AxTable3();
table3.SetTxi(taxTbl3);
pid05[0]);
pid05[1]);
pid05[2]);
pid05[3]);
pid05[4]);
//Create and Set Level23 Object
AxLevel23 level23 = new AxLevel23();
level23.SetTable1(table1);
level23.SetTable2(table2);
level23.SetTable3(table3);
AxCompletion axCompletion = new AxCompletion();
axCompletion.SetOrderId(order_id);
axCompletion.SetCompAmount(comp_amount);
axCompletion.SetTxnNumber(txn_number);
axCompletion.SetCryptType(crypt);
axCompletion.SetAxLevel23(level23);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(axCompletion);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
November 2018
Page 237 of 486
Moneris Gateway API - Integration Guide
Sample AX Completion
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.4.5 AX Force Post
The AX Force Post transaction is used to secure the funds locked by a pre-authorization transaction performed over IVR or equivalent terminal. When sending an AX Force Post request, you will need the order
ID, amount, credit card number, expiry date, authorization code and e-commerce indicator.
AX Force Post transaction object definition
AxForcePost axForcePost = new AxForcePost();
HttpsPostRequest object for AX Force Post transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(axForcePost);
Page 238 of 486
November 2018
7 Level 2/3 Transactions
AX Force Post transaction object values
Table 1 AX Force Post transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
axForcePost.SetOrderId(order_
id);
Amount
String
10-character decimal
axForcePost.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
String
20-character alphanumeric
axForcePost.SetPan(pan);
Expiry date
String
4-character alphanumeric
axForcePost.SetExpdate
(expiry_date);
(YYMM format)
Authorization code
String
8-character alphanumeric
axForcePost.SetAuthCode(auth_
code);
E-commerce indicator
String
1-character alphanumeric
axForcePost.SetCryptType
(crypt);
Level 2/3 Data
Object
n/a
axForcePost.SetAxLevel23
(level23);
Table 2 AX Force Post transaction object optional values
Value
Customer ID
Type
String
Limits
50-character alphanumeric
Set Method
axForcePost.SetCustId(cust_
id);
Sample AX Force Post
namespace Moneris
November 2018
Page 239 of 486
Moneris Gateway API - Integration Guide
Sample AX Force Post
{
using System;
using System.Collections;
using System.Text;
public class TestAxForcePost
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string
string
string
string
string
string
string
order_id="Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
cust_id="CUST13343";
amount="62.37";
pan="373269005095005";
expiry_date="2012"; //YYMM
auth_code="123456";
crypt="7";
//Create Table 1 with details
string n101 = "R6"; //Entity ID Code
string n102 = "Retailing Inc. International"; //Name
string n301 = "919 Oriole Rd."; //Address Line 1
string n401 = "Toronto"; //City
string n402 = "On"; //State or Province
string n403 = "H1T6W3"; //Postal Code
string[] ref01 = {"4C", "CR"}; //Reference ID Qualifier
string[] ref02 = {"M5T3A5", "16802309004"}; //Reference ID
string big04 = "PO7758545"; //Purchase Order Number
string big05 = "RN0049858"; //Release Number
string big10 = "INV99870E"; //Invoice Number
AxRef axRef1 = new AxRef();
axRef1.SetRef(ref01[0], ref02[0]);
axRef1.SetRef(ref01[1], ref02[1]);
AxN1Loop n1Loop = new AxN1Loop();
n1Loop.SetN1Loop(n101, n102, n301, n401, n402, n403, axRef1);
AxTable1 table1 = new AxTable1();
table1.SetBig04(big04);
table1.SetBig05(big05);
table1.SetBig10(big10);
table1.SetN1Loop(n1Loop);
//Create Table 2 with details
//the sum of the extended amount field (pam05) must equal the level 1 amount field
string[]
string[]
string[]
string[]
it102
it103
it104
it105
=
=
=
=
{"1", "1", "1", "1", "1"}; //Line item quantity invoiced
{"EA", "EA", "EA", "EA", "EA"}; //Line item unit or basis of measurement code
{"10.00", "25.00", "8.62", "10.00", "-10.00"}; //Line item unit price
{"", "", "", "", ""}; //Line item basis of unit price code
string[] it10618 = {"MG", "MG", "MG", "MG", "MG"}; //Product/Service ID qualifier
string[] it10719 = {"DJFR4", "JFJ49", "FEF33", "FEE43", "DISCOUNT"}; //Product/Service ID
(corresponds to it10618)
string[] txi01_GST = {"GS", "GS", "GS", "GS", "GS"}; //Tax type code
string[] txi02_GST = {"0.70", "1.75", "1.00", "0.80","0.00"}; //Monetary amount
string[] txi03_GST = {"", "", "", "",""}; //Percent
Page 240 of 486
November 2018
7 Level 2/3 Transactions
Sample AX Force Post
string[] txi06_GST = {"", "", "", "",""}; //Tax exempt code
string[] txi01_PST = {"PG", "PG", "PG","PG","PG"}; //Tax type code
string[] txi02_PST = {"0.80", "2.00", "1.00", "0.80","0.00"}; //Monetary amount
string[] txi03_PST = {"", "", "", "",""}; //Percent
string[] txi06_PST = {"", "", "", "",""}; //Tax exempt code
string[] pam05 = {"11.50", "28.75", "10.62", "11.50", "-10.00"}; //Extended line-item amount
string[] pid05 = {"Stapler", "Lamp", "Bottled Water", "Fountain Pen", "DISCOUNT"}; //Line item
description
AxIt106s[] it106s = {new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s
()};
it106s[0].SetIt10618(it10618[0]);
it106s[0].SetIt10719(it10719[0]);
it106s[1].SetIt10618(it10618[1]);
it106s[1].SetIt10719(it10719[1]);
it106s[2].SetIt10618(it10618[2]);
it106s[2].SetIt10719(it10719[2]);
it106s[3].SetIt10618(it10618[3]);
it106s[3].SetIt10719(it10719[3]);
it106s[4].SetIt10618(it10618[4]);
it106s[4].SetIt10719(it10719[4]);
AxTxi[] txi = {new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi()};
txi[0].SetTxi(txi01_GST[0], txi02_GST[0], txi03_GST[0], txi06_GST[0]);
txi[0].SetTxi(txi01_PST[0], txi02_PST[0], txi03_PST[0], txi06_PST[0]);
txi[1].SetTxi(txi01_GST[1], txi02_GST[1], txi03_GST[1], txi06_GST[1]);
txi[1].SetTxi(txi01_PST[1], txi02_PST[1], txi03_PST[1], txi06_PST[1]);
txi[2].SetTxi(txi01_GST[2], txi02_GST[2], txi03_GST[2], txi06_GST[2]);
txi[2].SetTxi(txi01_PST[2], txi02_PST[2], txi03_PST[2], txi06_PST[2]);
txi[3].SetTxi(txi01_GST[3], txi02_GST[3], txi03_GST[3], txi06_GST[3]);
txi[3].SetTxi(txi01_PST[3], txi02_PST[3], txi03_PST[3], txi06_PST[3]);
txi[4].SetTxi(txi01_GST[4], txi02_GST[4], txi03_GST[4], txi06_GST[4]);
txi[4].SetTxi(txi01_PST[4], txi02_PST[4], txi03_PST[4], txi06_PST[4]);
AxIt1Loop it1Loop = new AxIt1Loop();
it1Loop.SetIt1Loop(it102[0], it103[0], it104[0], it105[0], it106s[0], txi[0], pam05[0],
it1Loop.SetIt1Loop(it102[1], it103[1], it104[1], it105[1], it106s[1], txi[1], pam05[1],
it1Loop.SetIt1Loop(it102[2], it103[2], it104[2], it105[2], it106s[2], txi[2], pam05[2],
it1Loop.SetIt1Loop(it102[3], it103[3], it104[3], it105[3], it106s[3], txi[3], pam05[3],
it1Loop.SetIt1Loop(it102[4], it103[4], it104[4], it105[4], it106s[4], txi[4], pam05[4],
AxTable2 table2 = new AxTable2();
table2.SetIt1Loop(it1Loop);
//Create Table 3 with details
AxTxi taxTbl3 = new AxTxi();
taxTbl3.SetTxi("GS", "4.25","",""); //sum of GST taxes
taxTbl3.SetTxi("PG", "4.60","",""); //sum of PST taxes
taxTbl3.SetTxi("TX", "8.85","",""); //sum of all taxes
AxTable3 table3 = new AxTable3();
table3.SetTxi(taxTbl3);
pid05[0]);
pid05[1]);
pid05[2]);
pid05[3]);
pid05[4]);
AxLevel23 level23 = new AxLevel23();
level23.SetTable1(table1);
level23.SetTable2(table2);
level23.SetTable3(table3);
AxForcePost axForcePost = new AxForcePost();
axForcePost.SetOrderId(order_id);
November 2018
Page 241 of 486
Moneris Gateway API - Integration Guide
Sample AX Force Post
axForcePost.SetCustId(cust_id);
axForcePost.SetAmount(amount);
axForcePost.SetPan(pan);
axForcePost.SetExpDate(expiry_date);
axForcePost.SetAuthCode(auth_code);
axForcePost.SetCryptType(crypt);
axForcePost.SetAxLevel23(level23);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(axForcePost);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.4.6 AX Purchase Correction
The AX Purchase Correction (Void) transaction is used to cancel a transaction that was performed in the
current batch. No amount is required because a void is always for 100% of the original transaction. The
only transaction that can be voided using AX Purchase Correction is AX Completion and AX Force Post.
To send an AX Purchase Correction the Order ID and transaction number from the AX Completion or AX
Force Post are required.
Page 242 of 486
November 2018
7 Level 2/3 Transactions
AX Purchase Correction transaction object definition
AxPurchaseCorrection axPurchaseCorrection = new AxPurchaseCorrection();
HttpsPostRequest object for AX Purchase Correction transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(axPurchaseCorrection);
AX Purchase Correction transaction object values
Table 1 AX Purchase Correction transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
axPurchaseCorrection
.SetOrderId(order_id);
Transaction number
String
255-character alphanumeric
axPurchaseCorrection
.SetTxnNumber(txn_number);
E-commerce indicator
String
1-character alphanumeric
axPurchaseCorrection
.SetCryptType(crypt);
AX Purchase Correction
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestAxPurchaseCorrection
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string order_id="Test20170119104952";
string txn_number = "660117311852017019104953104-0_11";
string crypt="7";
AxPurchaseCorrection axPurchaseCorrection = new AxPurchaseCorrection();
axPurchaseCorrection.SetOrderId(order_id);
axPurchaseCorrection.SetTxnNumber(txn_number);
axPurchaseCorrection.SetCryptType(crypt);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(axPurchaseCorrection);
November 2018
Page 243 of 486
Moneris Gateway API - Integration Guide
AX Purchase Correction
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.4.7 AX Refund
The AX Refund will credit a specified amount to the cardholder’s credit card. A refund can be sent up to
the full value of the original AX Completion or AX Force Post. To send an AX Refund you will require the
Order ID and transaction number from the original AX Completion or AX Force Post.
AX Refund transaction object definition
AxRefund axRefund = new AxRefund();
HttpsPostRequest object for AX Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(axRefund);
Page 244 of 486
November 2018
7 Level 2/3 Transactions
AX Refund transaction object values
Table 1 AX Refund transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
axRefund.SetOrderId(order_
id);
Transaction number
String
255-character alphanumeric
axRefund.SetTxnNumber(txn_
number);
Amount
String
10-character decimal
axRefund.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
E-commerce indicator
String
1-character alphanumeric
axRefund.SetCryptType(crypt);
Level 2/3 Data
Object
n/a
axRefund.SetAxLevel23
(level23);
Sample AX Refund
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestAxRefund
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string
string
string
string
order_id="ord-210916-12:06:38";
amount="62.37";
txn_number = "18924-4_11";
crypt="7";
//Create Table 1 with details
string n101 = "R6"; //Entity ID Code
November 2018
Page 245 of 486
Moneris Gateway API - Integration Guide
Sample AX Refund
string n102 = "Retailing Inc. International"; //Name
string n301 = "919 Oriole Rd."; //Address Line 1
string n401 = "Toronto"; //City
string n402 = "On"; //State or Province
string n403 = "H1T6W3"; //Postal Code
string[] ref01 = {"4C", "CR"}; //Reference ID Qualifier
string[] ref02 = {"M5T3A5", "16802309004"}; //Reference ID
string big04 = "PO7758545"; //Purchase Order Number
string big05 = "RN0049858"; //Release Number
string big10 = "INV99870E"; //Invoice Number
AxRef axRef1 = new AxRef();
axRef1.SetRef(ref01[0], ref02[0]);
axRef1.SetRef(ref01[1], ref02[1]);
AxN1Loop n1Loop = new AxN1Loop();
n1Loop.SetN1Loop(n101, n102, n301, n401, n402, n403, axRef1);
AxTable1 table1 = new AxTable1();
table1.SetBig04(big04);
table1.SetBig05(big05);
table1.SetBig10(big10);
table1.SetN1Loop(n1Loop);
//Create Table 2
//the sum of the
string[] it102 =
string[] it103 =
string[] it104 =
string[] it105 =
with details
extended amount field (pam05) must equal the level 1 amount field
{"1", "1", "1", "1", "1"}; //Line item quantity invoiced
{"EA", "EA", "EA", "EA", "EA"}; //Line item unit or basis of measurement code
{"10.00", "25.00", "8.62", "10.00", "-10.00"}; //Line item unit price
{"", "", "", "", ""}; //Line item basis of unit price code
string[] it10618 = {"MG", "MG", "MG", "MG", "MG"}; //Product/Service ID qualifier
string[] it10719 = {"DJFR4", "JFJ49", "FEF33", "FEE43", "DISCOUNT"}; //Product/Service ID
(corresponds to it10618)
string[]
string[]
string[]
string[]
txi01_GST
txi02_GST
txi03_GST
txi06_GST
=
=
=
=
{"GS", "GS", "GS", "GS", "GS"}; //Tax type code
{"0.70", "1.75", "1.00", "0.80","0.00"}; //Monetary amount
{"", "", "", "",""}; //Percent
{"", "", "", "",""}; //Tax exempt code
string[] txi01_PST = {"PG", "PG", "PG","PG","PG"}; //Tax type code
string[] txi02_PST = {"0.80", "2.00", "1.00", "0.80","0.00"}; //Monetary amount
string[] txi03_PST = {"", "", "", "",""}; //Percent
string[] txi06_PST = {"", "", "", "",""}; //Tax exempt code
string[] pam05 = {"11.50", "28.75", "10.62", "11.50", "-10.00"}; //Extended line-item amount
string[] pid05 = {"Stapler", "Lamp", "Bottled Water", "Fountain Pen", "DISCOUNT"}; //Line item
description
AxIt106s[] it106s = {new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s
()};
it106s[0].SetIt10618(it10618[0]);
it106s[0].SetIt10719(it10719[0]);
it106s[1].SetIt10618(it10618[1]);
it106s[1].SetIt10719(it10719[1]);
it106s[2].SetIt10618(it10618[2]);
it106s[2].SetIt10719(it10719[2]);
it106s[3].SetIt10618(it10618[3]);
it106s[3].SetIt10719(it10719[3]);
Page 246 of 486
November 2018
7 Level 2/3 Transactions
Sample AX Refund
it106s[4].SetIt10618(it10618[4]);
it106s[4].SetIt10719(it10719[4]);
AxTxi[] txi = {new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi()};
txi[0].SetTxi(txi01_GST[0], txi02_GST[0], txi03_GST[0], txi06_GST[0]);
txi[0].SetTxi(txi01_PST[0], txi02_PST[0], txi03_PST[0], txi06_PST[0]);
txi[1].SetTxi(txi01_GST[1], txi02_GST[1], txi03_GST[1], txi06_GST[1]);
txi[1].SetTxi(txi01_PST[1], txi02_PST[1], txi03_PST[1], txi06_PST[1]);
txi[2].SetTxi(txi01_GST[2], txi02_GST[2], txi03_GST[2], txi06_GST[2]);
txi[2].SetTxi(txi01_PST[2], txi02_PST[2], txi03_PST[2], txi06_PST[2]);
txi[3].SetTxi(txi01_GST[3], txi02_GST[3], txi03_GST[3], txi06_GST[3]);
txi[3].SetTxi(txi01_PST[3], txi02_PST[3], txi03_PST[3], txi06_PST[3]);
txi[4].SetTxi(txi01_GST[4], txi02_GST[4], txi03_GST[4], txi06_GST[4]);
txi[4].SetTxi(txi01_PST[4], txi02_PST[4], txi03_PST[4], txi06_PST[4]);
AxIt1Loop it1Loop = new AxIt1Loop();
it1Loop.SetIt1Loop(it102[0], it103[0], it104[0], it105[0], it106s[0], txi[0], pam05[0],
it1Loop.SetIt1Loop(it102[1], it103[1], it104[1], it105[1], it106s[1], txi[1], pam05[1],
it1Loop.SetIt1Loop(it102[2], it103[2], it104[2], it105[2], it106s[2], txi[2], pam05[2],
it1Loop.SetIt1Loop(it102[3], it103[3], it104[3], it105[3], it106s[3], txi[3], pam05[3],
it1Loop.SetIt1Loop(it102[4], it103[4], it104[4], it105[4], it106s[4], txi[4], pam05[4],
AxTable2 table2 = new AxTable2();
table2.SetIt1Loop(it1Loop);
//Create Table 3 with details
AxTxi taxTbl3 = new AxTxi();
taxTbl3.SetTxi("GS", "4.25","",""); //sum of GST taxes
taxTbl3.SetTxi("PG", "4.60","",""); //sum of PST taxes
taxTbl3.SetTxi("TX", "8.85","",""); //sum of all taxes
AxTable3 table3 = new AxTable3();
table3.SetTxi(taxTbl3);
pid05[0]);
pid05[1]);
pid05[2]);
pid05[3]);
pid05[4]);
//Create and Set Level23 Object
AxLevel23 level23 = new AxLevel23();
level23.SetTable1(table1);
level23.SetTable2(table2);
level23.SetTable3(table3);
AxRefund axRefund = new AxRefund();
axRefund.SetOrderId(order_id);
axRefund.SetAmount(amount);
axRefund.SetTxnNumber(txn_number);
axRefund.SetCryptType(crypt);
axRefund.SetAxLevel23(level23);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(axRefund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
November 2018
Page 247 of 486
Moneris Gateway API - Integration Guide
Sample AX Refund
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
7.4.8 AX Independent Refund
The AX Independent Refund will credit a specified amount to the cardholder’s credit card. The independent refund does not require an existing order to be logged in the Moneris Gateway; however, the
credit card number and expiry date will need to be passed.
AX Independent Refund transaction object definition
AxIndependentRefund axIndependentRefund = new AxIndependentRefund();
HttpsPostRequest object for AX Independent Refund transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(axIndependentRefund);
Page 248 of 486
November 2018
7 Level 2/3 Transactions
AX Independent Refund transaction object values
Table 1 AX Independent Refund transaction object mandatory values
Value
Type
Limits
Set Method
Order ID
String
50-character alphanumeric
axIndependentRefund
.SetOrderId(order_id);
Amount
String
10-character decimal
axIndependentRefund.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
String
20-character alphanumeric
axIndependentRefund.SetPan
(pan);
Expiry date
String
4-character alphanumeric
axIndependentRefund
.SetExpdate(expiry_date);
(YYMM format)
E-commerce indicator
String
1-character alphanumeric
axIndependentRefund
.SetCryptType(crypt);
Table 2 AX Independent Refund transaction object optional values
Value
Customer ID
Type
String
Limits
50-character alphanumeric
Set Method
axIndependentRefund.SetCustId
(cust_id);
Sample AX Independent Refund
namespace Moneris
{
using System;
using System.Collections;
using System.Text;
public class TestAxIndependentRefund
{
public static void Main(string[] args)
{
November 2018
Page 249 of 486
Moneris Gateway API - Integration Guide
Sample AX Independent Refund
string store_id = "moneris";
string api_token = "hurgle";
string processing_country_code = "CA";
bool status_check = false;
string
string
string
string
string
string
order_id="Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
cust_id="CUST13343";
amount="62.37";
pan="373269005095005";
expiry_date="2012"; //YYMM
crypt="7";
//Create Table 1 with details
string n101 = "R6"; //Entity ID Code
string n102 = "Retailing Inc. International"; //Name
string n301 = "919 Oriole Rd."; //Address Line 1
string n401 = "Toronto"; //City
string n402 = "On"; //State or Province
string n403 = "H1T6W3"; //Postal Code
string[] ref01 = {"4C", "CR"}; //Reference ID Qualifier
string[] ref02 = {"M5T3A5", "16802309004"}; //Reference ID
string big04 = "PO7758545"; //Purchase Order Number
string big05 = "RN0049858"; //Release Number
string big10 = "INV99870E"; //Invoice Number
AxRef axRef1 = new AxRef();
axRef1.SetRef(ref01[0], ref02[0]);
axRef1.SetRef(ref01[1], ref02[1]);
AxN1Loop n1Loop = new AxN1Loop();
n1Loop.SetN1Loop(n101, n102, n301, n401, n402, n403, axRef1);
AxTable1 table1 = new AxTable1();
table1.SetBig04(big04);
table1.SetBig05(big05);
table1.SetBig10(big10);
table1.SetN1Loop(n1Loop);
//Create Table 2
//the sum of the
string[] it102 =
string[] it103 =
string[] it104 =
string[] it105 =
with details
extended amount field (pam05) must equal the level 1 amount field
{"1", "1", "1", "1", "1"}; //Line item quantity invoiced
{"EA", "EA", "EA", "EA", "EA"}; //Line item unit or basis of measurement code
{"10.00", "25.00", "8.62", "10.00", "-10.00"}; //Line item unit price
{"", "", "", "", ""}; //Line item basis of unit price code
string[] it10618 = {"MG", "MG", "MG", "MG", "MG"}; //Product/Service ID qualifier
string[] it10719 = {"DJFR4", "JFJ49", "FEF33", "FEE43", "DISCOUNT"}; //Product/Service ID
(corresponds to it10618)
string[]
string[]
string[]
string[]
txi01_GST
txi02_GST
txi03_GST
txi06_GST
=
=
=
=
{"GS", "GS", "GS", "GS", "GS"}; //Tax type code
{"0.70", "1.75", "1.00", "0.80","0.00"}; //Monetary amount
{"", "", "", "",""}; //Percent
{"", "", "", "",""}; //Tax exempt code
string[] txi01_PST = {"PG", "PG", "PG","PG","PG"}; //Tax type code
string[] txi02_PST = {"0.80", "2.00", "1.00", "0.80","0.00"}; //Monetary amount
string[] txi03_PST = {"", "", "", "",""}; //Percent
string[] txi06_PST = {"", "", "", "",""}; //Tax exempt code
string[] pam05 = {"11.50", "28.75", "10.62", "11.50", "-10.00"}; //Extended line-item amount
string[] pid05 = {"Stapler", "Lamp", "Bottled Water", "Fountain Pen", "DISCOUNT"}; //Line item
description
AxIt106s[] it106s = {new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s(), new AxIt106s
Page 250 of 486
November 2018
7 Level 2/3 Transactions
Sample AX Independent Refund
()};
it106s[0].SetIt10618(it10618[0]);
it106s[0].SetIt10719(it10719[0]);
it106s[1].SetIt10618(it10618[1]);
it106s[1].SetIt10719(it10719[1]);
it106s[2].SetIt10618(it10618[2]);
it106s[2].SetIt10719(it10719[2]);
it106s[3].SetIt10618(it10618[3]);
it106s[3].SetIt10719(it10719[3]);
it106s[4].SetIt10618(it10618[4]);
it106s[4].SetIt10719(it10719[4]);
AxTxi[] txi = {new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi(), new AxTxi()};
txi[0].SetTxi(txi01_GST[0], txi02_GST[0], txi03_GST[0], txi06_GST[0]);
txi[0].SetTxi(txi01_PST[0], txi02_PST[0], txi03_PST[0], txi06_PST[0]);
txi[1].SetTxi(txi01_GST[1], txi02_GST[1], txi03_GST[1], txi06_GST[1]);
txi[1].SetTxi(txi01_PST[1], txi02_PST[1], txi03_PST[1], txi06_PST[1]);
txi[2].SetTxi(txi01_GST[2], txi02_GST[2], txi03_GST[2], txi06_GST[2]);
txi[2].SetTxi(txi01_PST[2], txi02_PST[2], txi03_PST[2], txi06_PST[2]);
txi[3].SetTxi(txi01_GST[3], txi02_GST[3], txi03_GST[3], txi06_GST[3]);
txi[3].SetTxi(txi01_PST[3], txi02_PST[3], txi03_PST[3], txi06_PST[3]);
txi[4].SetTxi(txi01_GST[4], txi02_GST[4], txi03_GST[4], txi06_GST[4]);
txi[4].SetTxi(txi01_PST[4], txi02_PST[4], txi03_PST[4], txi06_PST[4]);
AxIt1Loop it1Loop = new AxIt1Loop();
it1Loop.SetIt1Loop(it102[0], it103[0], it104[0], it105[0], it106s[0], txi[0], pam05[0],
it1Loop.SetIt1Loop(it102[1], it103[1], it104[1], it105[1], it106s[1], txi[1], pam05[1],
it1Loop.SetIt1Loop(it102[2], it103[2], it104[2], it105[2], it106s[2], txi[2], pam05[2],
it1Loop.SetIt1Loop(it102[3], it103[3], it104[3], it105[3], it106s[3], txi[3], pam05[3],
it1Loop.SetIt1Loop(it102[4], it103[4], it104[4], it105[4], it106s[4], txi[4], pam05[4],
AxTable2 table2 = new AxTable2();
table2.SetIt1Loop(it1Loop);
//Create Table 3 with details
AxTxi taxTbl3 = new AxTxi();
taxTbl3.SetTxi("GS", "4.25","",""); //sum of GST taxes
taxTbl3.SetTxi("PG", "4.60","",""); //sum of PST taxes
taxTbl3.SetTxi("TX", "8.85","",""); //sum of all taxes
AxTable3 table3 = new AxTable3();
table3.SetTxi(taxTbl3);
pid05[0]);
pid05[1]);
pid05[2]);
pid05[3]);
pid05[4]);
//Create and Set Level23 Object
AxLevel23 level23 = new AxLevel23();
level23.SetTable1(table1);
level23.SetTable2(table2);
level23.SetTable3(table3);
AxIndependentRefund axIndependentRefund = new AxIndependentRefund();
axIndependentRefund.SetOrderId(order_id);
axIndependentRefund.SetCustId(cust_id);
axIndependentRefund.SetAmount(amount);
axIndependentRefund.SetPan(pan);
axIndependentRefund.SetExpDate(expiry_date);
axIndependentRefund.SetCryptType(crypt);
axIndependentRefund.SetAxLevel23(level23);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
November 2018
Page 251 of 486
Moneris Gateway API - Integration Guide
Sample AX Independent Refund
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(axIndependentRefund);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
Page 252 of 486
November 2018
8 MPI
l
l
l
l
l
l
8.1
8.2
8.3
8.4
8.5
8.6
About MPI Transactions
3-D Secure Implementations (VbV, MCSC, SafeKey)
Activating VbV and MCSC
Activating Amex SafeKey
Transaction Flow for MPI
MPI Transactions
8.1 About MPI Transactions
The Moneris Gateway can enable transactions using the 3-D Secure protocol via Merchant Plug-In (MPI)
and Access Control Server (ACS) .
Moneris Gateway supports the following 3-D Secure implementations:
l
l
l
Verified by Visa (VbV)
Mastercard Secure Code (MCSC)
American Express SafeKey (applies to Canadian integrations only)
8.2 3-D Secure Implementations (VbV, MCSC, SafeKey)
Verified by Visa (VbV), MasterCard Secure Code (MCSC) and American Express SafeKey are programs
based on the 3-D Secure Protocol to improve the security of online transactions.
These programs involve authentication of the cardholder during an online e-commerce transaction.
Authentication is based on the issuer’s selected method of authentication.
The following are examples of authentication methods:
l
l
l
Risk-based authentication
Dynamic passwords
Static passwords.
Some benefits of these programs are reduced risk of fraudulent transactions and protection against
chargebacks for certain fraudulent transactions.
Additional eFraud features
To further decrease fraudulent activity, Moneris also recommends implementing the following features:
l
l
AVS: Address Verification Service (page 291)
CVD: Card Validation Digits ().
November 2018
Page 253 of 486
Moneris Gateway API - Integration Guide
8.3 Activating VbV and MCSC
To integrate Verified by Visa and/or MasterCard Secure Code transaction functionality in your system,
call Moneris Sales Support to have Moneris enroll you in the program(s) and enable the functionality on
your account.
8.4 Activating Amex SafeKey
To Activate Amex SafeKey transaction functionality with your system via the Moneris Gateway API:
1. Enroll in the SafeKey program with American Express
at: https://network.americanexpress.com/ca/en/safekey/index.aspx
2. Call your Moneris sales centre at 1-855-465-4980 to get Amex SafeKey functionality enabled on
your account.
8.5 Transaction Flow for MPI
Figure 3: Transaction flow diagram
1. Cardholder enters the credit card number and submits the transaction information to the merchant.
2. Upon receiving the transaction request, the merchant calls the MonerisMPI API and passes a
TXN type request. For sample code please refer to MpiTxn Request Transaction (page 258).
3. The Moneris MPI receives the request, authenticates the merchant and sends the transaction
information to Visa, MasterCard or American Express.
4. Visa/MasterCard/Amex verifies that the card is enrolled and returns the issuer URL.
5. Moneris MPI receives the response from Visa, MasterCard or Amex and forwards the information to the merchant.
6. The MonerisMPI API installed at the merchant receives the response from the Moneris MPI.
If the response is "Y" for enrolled, the merchant makes a call to the API, which opens a popup/inline window in the cardholder browser.
If the response is “N” for not enrolled, a transaction could be sent to the processor identifying it
as VBV/MCSC/SafeKey attempted with an ECI value of 6.
Page 254 of 486
November 2018
8 MPI
7.
8.
9.
10.
11.
12.
If the response is “U” for unable to authenticate or the response times out, the transaction can
be sent to the processor with an ECI value of 7. The merchant can then choose to continue with
the transaction and be liable for a chargeback, or the merchant can choose to end the transaction.
The cardholder browser uses the URL that was returned from Visa/MasterCard/Amex via the merchant to communicate directly to the bank. The contents of the popup are loaded and the cardholder enters the PIN.
The information is submitted to the bank and authenticated. A response is then returned to the
client browser.
The client browser receives the response from the bank, and forwards it to the merchant.
The merchant receives the response information from the cardholder browser, and passes an
ACS request type to the Moneris MPI API.
Moneris MPI receives the ACS request and authenticates the information. The Moneris MPI then
provides a CAVV value (getCavv()) and a crypt type (getMpiEciO) to the merchant.
If the getSuccess() of the response is “true”, the merchant may proceed with the cavv purchase
or cavv preauth.
If the getSuccess() of the response is “false” and the getMessage() is “N”, the transaction must be
cancelled because the cardholder failed to authenticate.
If the getSuccess() of the response is “false” and the getMessage is “U”, the transaction can be
processed as a normal purchase or PreAuth; however in this case the merchant assumes liability
of a chargeback.
If the response times out, the transaction can be processed as a normal purchase or PreAuth;
however in this case the merchant assumes liability of a chargeback.
The merchant retrieves the CAVV value, and formats a cavv purchase or a cavv preauth request
using the method that is normally used. As part of this transaction method, the merchant must
pass the CAVV value and the crypt type.
8.6 MPI Transactions
Any of the transaction objects that are defined in this section can be passed to the HttpsPostRequest
connection object defined in Section 17.5 (page 391)here.
TXN
Sends the initial transaction data to the Moneris MPI to verify whether the card is enrolled.
The browser returns a PARes as well as a success field.
ACS
Passes the PARes (received in the response to the TXN transaction) to the Moneris MPI API.
Cavv Purchase
After receiving confirmation from the ACS transaction, this verifies funds on the customer’s
card, removes the funds and prepares them for deposit into the merchant’s account.
Cavv Pre-Authorization
After receiving confirmation from the ACS transaction, this verifies and locks funds on the customer’s credit card. The funds are locked for a specified amount of time based on the card
issuer.
November 2018
Page 255 of 486
Moneris Gateway API - Integration Guide
To retrieve the funds that have been locked by a Pre-Authorization transaction so that they
may be settled in the merchant’s account, a basic Completion transaction (page 25) must be
performed. A PreAuthorization transaction may only be "completed" once.
NOTE: Cavv Purchase and Cavv Pre-Authorization transactions are also used to process
Apple Pay and Android Pay transactions. For further details on how to process these wallet
transactions, please refer to 10 Apple Pay In-App and on the Web Integration.
8.6.1 VbV, MCSC and SafeKey Responses
For each transaction, a crypt type is sent to identify whether it is a VbV-, MCSC- or SafeKey-authenticated
transaction. Below are the tables defining the possible crypt types as well as the possible VARes and
PARes responses.
Table 71: Crypt type definitions
Crypt
type
5
Visa definition
l
l
6
l
l
7
l
l
l
Fully authenticated
There is a liability shift,
and the merchant is protected from chargebacks
VbV has been attempted
There is a liability shift,
and the merchant is protected from certain
chargebacks on fraudulent transactions
Non-VbV transaction
No liability shift
Merchant is not protected from chargebacks
Page 256 of 486
MasterCard definition
l
l
l
l
l
l
l
Fully authenticated
There is a liability shift,
and the merchant is protected from chargebacks.
MCSC has been attempted
There is a liability shift,
and the merchant is protected from certain
chargebacks on fraudulent transactions
Non-MCSC transaction
No liability shift
Merchant is not protected from chargebacks
American Express Definition
l
l
l
l
l
l
l
Fully authenticated
There is a liability shift,
and the merchant is protected from chargebacks.
SafeKey has been attempted
There is a liability shift,
and the merchant is protected from certain
chargebacks on fraudulent transactions
Non-SafeKey transaction
No liability shift
Merchant is not protected from chargebacks
November 2018
8 MPI
Table 72: VERes response definitions
VERes Response
Response Definition
N
The card/issuer is not enrolled.
Sent as a normal Purchase/PreAuth transaction with a crypt type of 6.
U
The card type is not participating in VbV/MCSC/SafeKey. It could be corporate
card or another card plan that Visa/MasterCard/Amex excludes.
Proceed with a regular transaction with a crypt type of 7 or cancel the transaction.
Y
The card is enrolled.
Proceed to create the VbV/MCSC/SafeKey inline window for cardholder authentication. Proceed to PARes for crypt type.
Table 73: PARes response definitions
PARes response
Response definition
A
Attempted to verify PIN, and will receive a CAVV.
Send as a cavv_purchase/cavv_preAuth, which returns a crypt type of 6.
Y
Fully authenticated, and will receive a CAVV.
Send as a cavv_purchase/cavv_preAuth which will return a crypt type of 5.
N
Failed to authenticate. No CAVV is returned.
Cancel transaction.
Merchant may proceed with a crypt type of 7 although this is strongly discouraged.
Table 74: 3-D Secure/CAVV transaction handling
Step 1: VERes
Step 2: PARes
Cardholder/issuer
enrolled?
VbV/MCSC InLine
window response
Step 3: Transaction
Are you protected?
Y
Y
Send a CAVV transaction
Y
N
Cancel transaction. Authentication failed or high-risk
transaction.
Y
A
Send a CAVV transaction
U
n/a
Send a regular transaction with a crypt type of 7
N
n/a
Send a regular transaction with a crypt type of 6
November 2018
Page 257 of 486
Moneris Gateway API - Integration Guide
8.6.2 MpiTxn Request Transaction
MpiTxn transaction object definition
MpiTxn mpiTxn = new MpiTxn();
HttpsPostRequest object for MpiTxn transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(mpiTxn);
MpiTxn transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 75: MpiTxn transaction object mandatory values
Value
Type
Limits
Set method
XID
String
20-character alphanumeric
mpiTxn.SetXid(xid);
Credit card number
String
20-character numeric
mpiTxn.SetPan(pan);
Expiry date
String
4-character alphanumeric
mpiTxn.SetExpdate(expiry_
date);
(YYMM format)
Amount
String
10-character decimal
mpiTxn.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
MD
String
1024-character alphanumeric
mpiTxn.SetMD(MD);
Merchant URL
String
N/A
mpiTxn.SetMerchantUrl
(merchantUrl);
Accept
String
N/A
mpiTxn.SetAccept(accept);
User Agent
String
N/A
mpiTxn.SetUserAgent
(userAgent);
Page 258 of 486
November 2018
8 MPI
Sample MpiTxn Request
namespace Moneris
{
using System;
using System.Text;
public class TestCanadaMpiTxn
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string amount = "1.00";
Random r = new Random();
StringBuilder sb = new StringBuilder();
for(int i=0; i< 20; i++)
{
sb.Append(r.Next(0,9));
}
string xid = sb.ToString();
//string MD = xid + "mycardinfo" + amount;
string MD = "xid=99999999999999992464&pan=4242424242424242&expiry=1511&amount=1.00";
string merchantUrl = "https://YOUR_MPI_RESPONSE_URL";
string accept = "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8";
string userAgent = "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko)
Chrome/43.0.2357.130 Safari/537.36";
string processing_country_code = "CA";
string pan = "4242424242424242";
string expdate = "1511";
bool status_check = false;
MpiTxn mpiTxn = new MpiTxn();
mpiTxn.SetXid(xid);
mpiTxn.SetPan(pan);
mpiTxn.SetExpDate(expdate);
mpiTxn.SetAmount(amount);
mpiTxn.SetMD(MD);
mpiTxn.SetMerchantUrl(merchantUrl);
mpiTxn.SetAccept(accept);
mpiTxn.SetUserAgent(userAgent);
//************************OPTIONAL VARIABLES***************************
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(mpiTxn);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
/********************** REQUEST ************************/
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("MpiMessage = " + receipt.GetMpiMessage());
Console.WriteLine("MpiSuccess = " + receipt.GetMpiSuccess());
if (receipt.GetMpiSuccess() == "true")
{
Console.WriteLine(receipt.GetInLineForm());
}
Console.ReadLine();
}
catch (Exception e)
November 2018
Page 259 of 486
Moneris Gateway API - Integration Guide
Sample MpiTxn Request
{
Console.WriteLine(e);
}
}
} // end TestResMpiTxn
}
8.6.2.1 TXN Response and Creating the Popup
The TXN request returns a response with one of several possible values. The get Message method of the
response object returns “Y”, “U”, or “N”.
N
Purchase or Pre-Authorization can be sent as a crypt type of 6 (attempted authentication).
Y
A call to the API to create the VBV form is made.
U
(Returned for non-participating cards such as corporate cards)
Merchant can send the transaction with crypt_type 7. However, the merchant is liable for
chargebacks.
8.6.3 Vault MPI Transaction – ResMpiTxn
Vault MPI Transaction transaction object definition
ResMpiTxn resMpiTxn = new ResMpiTxn();
HttpsPostRequest object for Vault MPI Transaction transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(resMpiTxn);
Vault MPI Transaction transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 76: Vault MPI Transaction transaction object mandatory values
Value
Type
Limits
Set method
Data key
String
25-character alphanumeric
resMpiTxn.SetData(data_key);
XID
String
20-character alphanumeric
resMpiTxn.SetXid(xid);
Amount
String
10-character decimal
resMpiTxn.SetAmount(amount);
Page 260 of 486
November 2018
8 MPI
Table 76: Vault MPI Transaction transaction object mandatory values (continued)
Value
Type
Limits
Set method
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
MD
String
1024-character alphanumeric
resMpiTxn.SetMD(MD);
Merchant URL
String
n/a
resMpiTxn.SetMerchantUrl
(merchantUrl);
Accept
String
n/a
resMpiTxn.SetAccept(accept);
User Agent
String
n/a
resMpiTxn.SetUserAgent
(userAgent);
Expiry date
String
4-character alphanumeric
resMpiTxn.SetExpdate(expiry_
date);
(YYMM format)
Sample Vault MPI Transaction
namespace Moneris
{
using System;
using System.Text;
using System.Collections;
public class TestCanadaResMpiTxn
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string data_key = "SzSrdoy0bt8UFXOtgS88wFAy7";
string amount = "1.00";
Random r = new Random();
StringBuilder sb = new StringBuilder();
for(int i=0; i< 20; i++)
{
sb.Append(r.Next(0,9));
}
string xid = sb.ToString();
November 2018
Page 261 of 486
Moneris Gateway API - Integration Guide
Sample Vault MPI Transaction
string MD = xid + "mycardinfo" + amount;
string merchantUrl = "www.mystoreurl.com";
string accept = "true";
string userAgent = "Mozilla";
string processing_country_code = "CA";
bool status_check = false;
ResMpiTxn resMpiTxn = new ResMpiTxn();
resMpiTxn.SetData(data_key);
resMpiTxn.SetXid(xid);
resMpiTxn.SetAmount(amount);
resMpiTxn.SetMD(MD);
resMpiTxn.SetMerchantUrl(merchantUrl);
resMpiTxn.SetAccept(accept);
resMpiTxn.SetUserAgent(userAgent);
//************************OPTIONAL VARIABLES***************************
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(resMpiTxn);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
/********************** REQUEST ************************/
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("MpiMessage = " + receipt.GetMpiMessage());
Console.WriteLine("MpiSuccess = " + receipt.GetMpiSuccess());
if (receipt.GetMpiSuccess() == "true")
{
Console.WriteLine(receipt.GetInLineForm());
}
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
} // end TestResMpiTxn
}
Vault response fields
For a list and explanation of (Receipt object) response fields that are available after sending this Vault
transaction, see Definitions of Response Fields (page 447).
8.6.4 MPI ACS Request Transaction
MPI ACS Request transaction object definition
MpiAcs mpiAcs = new MpiAcs();
HttpsPostRequest object for MPI ACS Request transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
Page 262 of 486
November 2018
8 MPI
mpgReq.SetTransaction(mpiAcs);
MPI ACS Request transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 77: MPI ACS Request transaction object mandatory values
Value
Type
Limits
XID
String
20-character alphanumeric
Amount
String
10-character decimal
Set method
NOTE: Is the concatenated 20-character
prefix that forms part of the variable MD
mpiAcs.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
MD
String
1024-character alphanumeric
mpiAcs.SetMD(MD);
PARes
String
n/a
mpiAcs.SetPaRes(PaRes);
Sample MPI ACS Request
namespace Moneris
{
using System;
public class TestCanadaMpiAcs
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string amount = "1.00";
string xid = "12345678910111214005";
string MD = xid + "mycardinfo" + amount;
string PaRes = "PaRes String";
string processing_country_code = "CA";
bool status_check = false;
MpiAcs resMpiAcs = new MpiAcs();
resMpiAcs.SetPaRes(PaRes);
resMpiAcs.SetMD(MD);
//************************OPTIONAL VARIABLES***************************
HttpsPostRequest mpgReq = new HttpsPostRequest();
November 2018
Page 263 of 486
Moneris Gateway API - Integration Guide
Sample MPI ACS Request
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(resMpiAcs);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
/********************** REQUEST ************************/
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("MpiMessage = " + receipt.GetMpiMessage());
Console.WriteLine("MpiSuccess = " + receipt.GetMpiSuccess());
if (receipt.GetMpiSuccess() == "true")
{
Console.WriteLine("Cavv = " + receipt.GetMpiCavv());
Console.WriteLine("Crypt Type = " + receipt.GetMpiEci());
}
else
{
Console.WriteLine("Message = " + receipt.GetMessage());
}
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
8.6.4.1 ACS Response and Forming a Transaction
The ACS response contains the CAVV value and the e-commerce indicator. These values are to be passed
to the transaction engine using the Cavv Purchase or Cavv Pre-Authorization request. Please see the documentation provided by your payment solution.
Outlined below is how to send a transaction to Moneris Gateway.
if ( mpiRes.getSuccess().equals("true") )
{
//Send transaction to host using CAVV purchase or CAVV preauth, refer to sample
//code for Moneris Gateway. Call mpiRes.getCavv() to obtain the CAVV value.
//If you are using preauth/capture model, be sure to call getMessage() so the
//value can be stored and used in the capture transaction after on to protect
//your chargeback liability. (e.g. getMPIMessage()= A = crypt type of 6 for
//follow on transaction and getMPIMessage() = Y = crypt type of 5 for follow on
//transaction.
}
else
{
if (mpiRes.getMessage().equals(“N”))
{
//Do not send transaction as the cardholder failed authentication.
}
else
{
//Optional to send transaction using the mpg API. In this case merchant
//assumes liability.
}
Page 264 of 486
November 2018
8 MPI
}
8.6.5 Purchase with 3-D Secure – cavvPurchase
The Purchase with 3-D Secure transaction follows a 3-D Secure MPI authentication. After receiving confirmation from the MPI ACS transaction, this Purchase verifies funds on the customer’s card, removes
the funds and prepares them for deposit into the merchant’s account.
To perform the 3-D Secure authentication, the Moneris MPI or any 3rd party MPI may be used.
This transaction can also be used to process an Apple Pay transaction. This transaction is applicable only
if choosing to integrate directly to Apple Wallet (if not using the Moneris Apple Pay SDK). Please refer to
10 Apple Pay In-App and on the Web Integration for more details on your integration options.
Refer to Apple's developer portal for details on integrating directly to the wallet to retrieve the payload
data.
Purchase with 3-D Secure transaction object definition
CavvPurchase cavvPurchase = new CavvPurchase();
HttpsPostRequest object for Purchase with 3-D Secure transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(cavvPurchase);
Cavv Purchase transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 78: Purchase with 3-D Secure transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
cavvPurchase.SetOrderId
(order_id);
Amount
String
10-character decimal
cavvPurchase.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
November 2018
String
20-character alphanumeric
cavvPurchase.SetPan(pan);
Page 265 of 486
Moneris Gateway API - Integration Guide
Table 78: Purchase with 3-D Secure transaction object mandatory values
Value
Expiry date
Type
String
Limits
4-character alphanumeric
Set method
cavvPurchase.SetExpdate
(expiry_date);
(YYMM format)
CAVV
String
50-character alphanumeric
cavvPurchase.SetCavv(cavv);
String
1-character alphanumeric
cavvPurchase.SetCryptType
(crypt);
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, CAVV field contains the decrypted
cryptogram. For more,
see Appendix A Definitions of Request
Fields.
E-commerce indicator
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, the E-commerce indicator is a
mandatory field containing the value
received from the
decrypted payload or a
default value of 5. If
you get a 2-character
value (e.g.,. 05 or 07)
from the payload,
remove the initial 0
and just send us the
2nd character. For
more, see Appendix A
Definitions of Request
Fields.
Page 266 of 486
November 2018
8 MPI
Table 1 INTERAC® e-Commerce Fields – Required for Apple Pay and Google Pay Only
Variable and Field
Name
Network
Type
Limits
Set Method
String
alphabetical
cavvPurchase.setNetwork
(network);
String
3-character alphanumeric
cavvPurchase.setDataType
(data_type);
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Data Type
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Table 2 Purchase with 3-D Secure transaction object optional values
Value
Type
Limits
Set Method
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Customer ID
String
50-character alphanumeric
cavvPurchase.SetCustId(cust_
id);
Dynamic descriptor
String
20-character alphanumeric
cavvPurchase
.SetDynamicDescriptor
(dynamic_descriptor);
Card Match ID
String
50-character alphanumeric
cavvPurchase.SetCmId
(transaction_id);
Object
N/A
cavvPurchase.SetCustInfo
(customer);
NOTE: Applies to Offlinx™ only; must be
unique value for each
transaction
Customer information
November 2018
Page 267 of 486
Moneris Gateway API - Integration Guide
Value
Type
Limits
Set Method
AVS
Object
N/A
cavvPurchase.SetAvsInfo
(avsCheck);
CVD
Object
N/A
cavvPurchase.SetCvdInfo
(cvdCheck);
Convenience fee
Object
N/A
cavvPurchase.SetConvFeeInfo
(convFeeInfo);
NOTE: Not applicable
when processing Apple
Pay transactions.
Page 268 of 486
November 2018
8 MPI
Value
Recurring billing
Type
Limits
Set Method
Object
N/A
cavvPurchase.SetRecur
(recurring_cycle);
String
3-character alphanumeric
cavvPurchase
.SetWalletIndicator(wallet_
indicator);
Object
N/A
cof.SetCofInfo(cof);
recur
NOTE: For sample code
for a Purchase with 3D Secure including the
Recurring Billing Info
Object, see 8.6.5.1
Purchase with 3-D
Secure and Recurring
Billing .
Wallet indicator
NOTE: For Cavv
Purchase and Cavv PreAuthorization, wallet
indicator applies to
Apple Pay or Android
Pay only. For more, see
Appendix A Definitions
of Request Fields
Credential on File Info
cof
NOTE: This is a nested
object within the transaction, and required
when storing or using
the customer's stored
credentials. The Credential on File Info
object has its own
request variables, listed in blue in the table
below, "Credential on
File Object Request
Variables".
November 2018
Page 269 of 486
Moneris Gateway API - Integration Guide
Credential on File Transaction Object Request Fields
Value
Issuer ID
Type
String
NOTE: This variable is
required for all merchant-intiated transactions following the
first one; upon sending
the first transaction,
the Issuer ID value is
received in the transaction response and
then used in subsequent transaction
requests.
Payment Indicator
Limits
15-character alphanumeric
variable length
String
1-character alphabetic
Set Method
cof.SetIssuerId("VALUE_FOR_
ISSUER_ID");
NOTE: For a list and explanation of the possible values to send for this variable, see
Definitions of Request Fields – Credential
on File
cof.SetPaymentIndicator
("PAYMENT_INDICATOR_VALUE");
NOTE: For a list and explanation of the possible values to send for this variable, see
Definitions of Request Fields – Credential
on File
Payment Information
String
1-character numeric
cof.SetPaymentInformation
("PAYMENT_INFO_VALUE");
NOTE: For a list and explanation of the possible values to send for this variable, see
Definitions of Request Fields – Credential
on File
Recurring Billing Info Object Request Fields
Variable and Field Name
Type and Limits
Description
Number of Recurs
String
num_recurs
numeric, 1-99
Period
String
period
numeric, 1-999
Number of recur units that
must pass between recurring
billings
Start Date
String
Date of the first future recurring
Page 270 of 486
The number of times that the
transaction must recur
November 2018
8 MPI
Variable and Field Name
start_date
Type and Limits
YYYY/MM/DD
Description
billing transaction
This value must be a date in the
future
If an additional charge is to be
made immediately, the value of
Start Now must be set to true
Start Now
String
start_now
true/false
If a single charge is to be made
against the card immediately,
set this value to true; the
amount to be billed immediately may differ from the
amount billed on a regular
basis thereafter
If the billing is to start in the
future, set this value to false
When set to false, use Card Verification prior to sending the
Purchase with Recur and Credential on File objects
Recurring Amount
String
recur_amount
10-character decimal
Up to 7 digits (dollars) + decimal
point (.) + 2 digits (cents) after
the decimal point
Amount of the recurring transaction
This is the amount that will be
billed on the Start Date and
then billed repeatedly based on
the interval defined by Period
and Recur Unit
EXAMPLE: 1234567.89
Recur Unit
String
recur_unit
day, week, month or eom
Unit to be used as a basis for
the interval
Works in conjunction with
Period to define the billing frequency
Possible values are:
day
week
month
November 2018
Page 271 of 486
Moneris Gateway API - Integration Guide
Variable and Field Name
Type and Limits
Description
eom (end of month)
Sample Purchase with 3-D Secure - cavvPurchase
namespace Moneris
{
using System;
using System.Collections;
public class TestCanadaCavvPurchase
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "CUS887H67";
string amount = "10.42";
string pan = "4242424242424242";
string expdate = "1901"; //YYMM
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA=";
string dynamic_descriptor = "123456";
string wallet_indicator = "APP";
string processing_country_code = "CA";
string crypt_type = "5";
bool status_check = false;
CofInfo cof = new CofInfo();
cof.SetPaymentIndicator("U");
cof.SetPaymentInformation("2");
cof.SetIssuerId("168451306048014");
CavvPurchase cavvPurchase = new CavvPurchase();
cavvPurchase.SetOrderId(order_id);
cavvPurchase.SetCustId(cust_id);
cavvPurchase.SetAmount(amount);
cavvPurchase.SetPan(pan);
cavvPurchase.SetExpDate(expdate);
cavvPurchase.SetCavv(cavv);
cavvPurchase.SetCryptType(crypt_type); //Mandatory for AMEX cards only
cavvPurchase.SetDynamicDescriptor(dynamic_descriptor);
//cavvPurchase.SetNetwork("Interac"); //set only for Interac e-commerce
//cavvPurchase.SetDataType("3DSecure"); //set only for Interac e-commerce
//cavvPurchase.SetWalletIndicator(wallet_indicator); //set only wallet transactions e.g. APPLE PAY
//cavvPurchase.SetCmId("8nAK8712sGaAkls56"); //set only for usage with Offlinx - Unique max 50
alphanumeric characters transaction id generated by merchant
cavvPurchase.SetCofInfo(cof);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(cavvPurchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Page 272 of 486
November 2018
8 MPI
Sample Purchase with 3-D Secure - cavvPurchase
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.WriteLine("IssuerId = " + receipt.GetIssuerId());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
8.6.5.1 Purchase with 3-D Secure and Recurring Billing
The example below illustrates the Purchase with 3-D Secure when also sending the Recurring Billing Info
object in the transaction.
Purchase with 3-D Secure and Recurring Billing
namespace Moneris
{
using System;
using System.Collections;
public class TestCanadaCavvPurchase
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "CUS887H67";
string amount = "10.42";
string pan = "4242424242424242";
string expdate = "1901"; //YYMM
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA=";
string dynamic_descriptor = "123456";
string wallet_indicator = "APP";
string processing_country_code = "CA";
string crypt_type = "5";
bool status_check = false;
/************************* Recur Variables **********************************/
string recur_unit = "month"; //eom = end of month
November 2018
Page 273 of 486
Moneris Gateway API - Integration Guide
Purchase with 3-D Secure and Recurring Billing
string start_now = "true";
string start_date = "2018/02/25";
string num_recurs = "12";
string period = "1";
string recur_amount = "30.00";
/************************* Recur Object Option1 ******************************/
Recur recurring_cycle = new Recur(recur_unit, start_now, start_date,
num_recurs, period, recur_amount);
/************************* Recur Object Option2 ******************************/
Hashtable recur_hash = new Hashtable();
recur_hash.Add("recur_unit", recur_unit);
recur_hash.Add("start_now", start_now);
recur_hash.Add("start_date", start_date);
recur_hash.Add("num_recurs", num_recurs);
recur_hash.Add("period", period);
recur_hash.Add("recur_amount", recur_amount);
Recur recurring_cycle2 = new Recur(recur_hash);
CofInfo cof = new CofInfo();
cof.SetPaymentIndicator("R");
cof.SetPaymentInformation("2");
cof.SetIssuerId("168451306048014");
CavvPurchase cavvPurchase = new CavvPurchase();
cavvPurchase.SetOrderId(order_id);
cavvPurchase.SetCustId(cust_id);
cavvPurchase.SetAmount(amount);
cavvPurchase.SetPan(pan);
cavvPurchase.SetExpDate(expdate);
cavvPurchase.SetCavv(cavv);
cavvPurchase.SetCryptType(crypt_type); //Mandatory for AMEX cards only
cavvPurchase.SetDynamicDescriptor(dynamic_descriptor);
//cavvPurchase.SetNetwork("Interac"); //set only for Interac e-commerce
//cavvPurchase.SetDataType("3DSecure"); //set only for Interac e-commerce
//cavvPurchase.SetWalletIndicator(wallet_indicator); //set only wallet transactions e.g. APPLE PAY
cavvPurchase.SetRecur(recurring_cycle);
cavvPurchase.SetCofInfo(cof);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(cavvPurchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Page 274 of 486
November 2018
8 MPI
Purchase with 3-D Secure and Recurring Billing
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.WriteLine("IssuerId = " + receipt.GetIssuerId());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
8.6.6 Pre-Authorization with 3-D Secure – cavvPreauth
The Pre-Authorization with 3-D Secure transaction follows a 3-D Secure MPI authentication. After receiving confirmation from the MPI ACS transaction, this Pre-Authorization verifies funds on the customer’s
card, removes the funds and prepares them for deposit into the merchant’s account.
To perform the 3-D Secure authentication, the Moneris MPI or any 3rd party MPI may be used.
This transaction can also be used to process an Apple Pay transaction. This transaction is applicable only
if choosing to integrate directly to Apple Wallet (if not using the Moneris Apple Pay SDK). Please refer to
10 Apple Pay In-App and on the Web Integration for more details on your integration options.
Refer to Apple's developer portal for details on integrating directly to the wallet to retrieve the payload
data.
Pre-Authorization with 3-D Secure transaction object definition
CavvPreAuth cavvPreauth = new CavvPreAuth();
HttpsPostRequest object for Pre-Authorization with 3-D Secure transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(cavvPreauth);
Pre-Authorization with 3-D Secure transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
November 2018
Page 275 of 486
Moneris Gateway API - Integration Guide
Table 79: Pre-Authorization with 3-D Secure object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
cavvPreauth.SetOrderId(order_
id);
Amount
String
10-character decimal
cavvPreauth.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
Page 276 of 486
String
20-character numeric
cavvPreauth.SetPan(pan);
November 2018
8 MPI
Value
Type
Limits
Set method
Cardholder Authentication Verification Value
(CAVV)
String
50-character alphanumeric
cavvPreauth.SetCavv(cavv);
Expiry date
String
4-character numeric
cavvPreauth.SetExpdate
(expiry_date);
E-commerce indicator
String
1-character alphanumeric
cavvPreauth.SetCryptType
(crypt);
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, CAVV field contains the decrypted
cryptogram. For more,
see Appendix A Definitions of Request
Fields.
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, the E-commerce indicator is a
mandatory field containing the value
received from the
decrypted payload or a
default value of 5. If
you get a 2-character
value (e.g.,. 05 or 07)
from the payload,
remove the initial 0
and just send us the
2nd character. For
more, see Appendix A
Definitions of Request
Fields.
November 2018
Page 277 of 486
Moneris Gateway API - Integration Guide
Table 1 INTERAC® e-Commerce Fields – Required for Apple Pay and Google Pay Only
Variable and Field
Name
Network
Type
Limits
Set Method
String
alphabetical
cavvPurchase.setNetwork
(network);
String
3-character alphanumeric
cavvPurchase.setDataType
(data_type);
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Data Type
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Table 2 Pre-Authorization with 3-D Secure object optional values
Value
Type
Limits
Set method
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Customer ID
String
50-character alphanumeric
cavvPreauth.SetCustId(cust_
id);
Dynamic descriptor
String
20-character alphanumeric
cavvPreauth
.SetDynamicDescriptor
(dynamic_descriptor);
Card Match ID
String
50-character alphanumeric
cavvPreauth.SetCmId
(transaction_id);
Object
N/A
cavvPreauth.SetAvsInfo
NOTE: Applies to Offlinx™ only; must be
unique value for each
transaction
AVS
Page 278 of 486
November 2018
8 MPI
Value
Type
Limits
Set method
(avsCheck);
CVD
Object
N/A
cavvPreauth.SetCvdInfo
(cvdCheck);
Wallet indicator
String
3-character alphanumeric
cavvPreauth
.SetWalletIndicator(wallet_
indicator);
Object
N/A
cof.SetCofInfo(cof);
NOTE: For Cavv
Purchase and Cavv PreAuthorization, wallet
indicator applies to
Apple Pay or Android
Pay only. For more, see
Appendix A Definitions
of Request Fields
Credential on File Info
cof
NOTE: This is a nested
object within the transaction, and required
when storing or using
the customer's stored
credentials. The Credential on File Info
object has its own
request variables, listed in blue in the table
below, "Credential on
File Object Request
Variables".
November 2018
Page 279 of 486
Moneris Gateway API - Integration Guide
Credential on File Transaction Object Request Fields
Value
Issuer ID
Type
String
NOTE: This variable is
required for all merchant-intiated transactions following the
first one; upon sending
the first transaction,
the Issuer ID value is
received in the transaction response and
then used in subsequent transaction
requests.
Payment Indicator
Limits
15-character alphanumeric
variable length
String
1-character alphabetic
Set Method
cof.SetIssuerId("VALUE_FOR_
ISSUER_ID");
NOTE: For a list and explanation of the possible values to send for this variable, see
Definitions of Request Fields – Credential
on File
cof.SetPaymentIndicator
("PAYMENT_INDICATOR_VALUE");
NOTE: For a list and explanation of the possible values to send for this variable, see
Definitions of Request Fields – Credential
on File
Payment Information
String
1-character numeric
cof.SetPaymentInformation
("PAYMENT_INFO_VALUE");
NOTE: For a list and explanation of the possible values to send for this variable, see
Definitions of Request Fields – Credential
on File
Sample Pre-Authorization with 3-D Secure – cavvPreauth
namespace Moneris
{
using System;
using System.Collections;
public class TestCanadaCavvPreauth
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "CUS887H67";
string amount = "10.42";
string pan = "4242424242424242";
string expdate = "1911"; //YYMM format
Page 280 of 486
November 2018
8 MPI
Sample Pre-Authorization with 3-D Secure – cavvPreauth
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA=";
string dynamic_descriptor = "123456";
string wallet_indicator = "APP";
string processing_country_code = "CA";
string crypt_type = "5";
bool status_check = false;
CofInfo cof = new CofInfo();
cof.SetPaymentIndicator("U");
cof.SetPaymentInformation("2");
cof.SetIssuerId("168451306048014");
CavvPreAuth cavvPreauth = new CavvPreAuth();
cavvPreauth.SetOrderId(order_id);
cavvPreauth.SetCustId(cust_id);
cavvPreauth.SetAmount(amount);
cavvPreauth.SetPan(pan);
cavvPreauth.SetExpDate(expdate);
cavvPreauth.SetCavv(cavv);
cavvPreauth.SetCryptType(crypt_type); //Mandatory for AMEX cards only
cavvPreauth.SetDynamicDescriptor(dynamic_descriptor);
//cavvPreauth.SetWalletIndicator(wallet_indicator); //set only wallet transactions e.g. APPLE PAY
//cavvPreauth.SetCmId("8nAK8712sGaAkls56"); //set only for usage with Offlinx - Unique max 50
alphanumeric characters transaction id generated by merchant
cavvPreauth.SetCofInfo(cof);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(cavvPreauth);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.WriteLine("IssuerId = " + receipt.GetIssuerId());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
November 2018
Page 281 of 486
Moneris Gateway API - Integration Guide
Sample Pre-Authorization with 3-D Secure – cavvPreauth
}
}
}
8.6.7 Cavv Result Codes for Verified by Visa
Table 80: CAVV result codes for VbV
Code
0
Message
Significance
CAVV authentication results
invalid
For this transaction, you may not receive protection from chargebacks as a result of using VbV
because the CAVV was considered invalid at the
time the financial transaction was processed.
Check that you are following the VbV process correctly and passing the correct data in our transactions.
1
CAVV failed validation;
authentication
Provided that you have implemented the VbV
process correctly, the liability for this transaction
should remain with the Issuer for chargeback
reason codes covered by Verified by Visa.
2
CAVV passed validation;
authentication
The CAVV was confirmed as part of the financial
transaction. This transaction is a fully authenticated VbV transaction (ECI 5)
3
CAVV passed validation;
attempt
The CAVV was confirmed as part of the financial
transaction. This transaction is an attempted
VbV transaction (ECI 6)
4
CAVV failed validation;
attempt
Provided that you have implemented the VbV
process correctly the liability for this transaction
should remain with the Issuer for chargeback
reason codes covered by Verified by Visa.
7
CAVV failed validation;
attempt (US issued cards
only)
Please check that you are following the VbV process correctly and passing the correct data in
your transactions.
Provided that you have implemented the VbV
process correctly the liability for this transaction
should be the same as an attempted transaction
(ECI 6)
Page 282 of 486
November 2018
8 MPI
Table 80: CAVV result codes for VbV (continued)
Code
Message
Significance
8
CAVV passed validation;
attempt (US issued cards
only
The CAVV was confirmed as part of the financial
transaction. This transaction is an attempted
VbV transaction (ECI 6)
9
CAVV failed validation;
attempt (US issued cards
only)
Please check that you are following the VbV process correctly and passing the correct data in our
transactions.
Provided that you have implemented the VbV
process correctly the liability for this transaction
should be the same as an attempted transaction
(ECI 6)
A
CAVV passed validation;
attempt (US issued cards
only)
The CAVV was confirmed as part of the financial
transaction. This transaction is an attempted
VbV transaction (ECI 6)
B
CAVV passed validation;
information only, no liability
shift
The CAVV was confirmed as part of the financial
transaction. However, this transaction does not
qualify for the liability shift. Treat this transaction
the same as an ECI 7.
8.6.8 Vault Cavv Purchase
Vault Cavv Purchase transaction object definition
ResCavvPurchaseCC resCavvPurchaseCC = new ResCavvPurchaseCC();
HttpsPostRequest object for Vault Cavv Purchase transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(resCavvPurchaseCC);
November 2018
Page 283 of 486
Moneris Gateway API - Integration Guide
Vault Cavv Purchase transaction details
Table 81: Vault Cavv Purchase transaction object mandatory values
Value
Type
Limits
Set method
Data Key
String
25-character alphanumeric
resCavvPurchaseCC.SetData
(data_key);
Order ID
String
50-character alphanumeric
resCavvPurchaseCC.SetOrderId
(order_id);
Amount
String
10-character decimal
resCavvPurchaseCC.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Cardholder Authentication Verification Value
(CAVV)
String
50-character alphanumeric
resCavvPurchaseCC.SetCavv
(cavv);
E-commerce indicator
String
1-character alphanumeric
resCavvPurchaseCC
.SetCryptType(crypt);
Table 82: Vault Cavv Purchase transaction object optional values
Value
Type
Limits
Set method
Customer ID
String
50-character alphanumeric
resCavvPurchaseCC.SetCustId
(cust_id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Expiry date
String
4-character alphanumeric
resCavvPurchaseCC.SetExpdate
(expiry_date);
(YYMM format)
Page 284 of 486
November 2018
8 MPI
Sample Vault Cavv Purchase
namespace Moneris
{
using System;
using System.Text;
using System.Collections;
public class TestCanadaResCavvPreauthCC
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string data_key = "4INQR1A8ocxD0oafSz50LADXy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string amount = "1.00";
string cust_id = "customer1"; //if sent will be submitted, otherwise cust_id from profile will be
used
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA";
string expdate = "1911";
string processing_country_code = "CA";
bool status_check = false;
ResCavvPreauthCC resCavvPreauthCC = new ResCavvPreauthCC();
resCavvPreauthCC.SetOrderId(order_id);
resCavvPreauthCC.SetDataKey(data_key);
resCavvPreauthCC.SetCustId(cust_id);
resCavvPreauthCC.SetAmount(amount);
resCavvPreauthCC.SetCavv(cavv);
//resCavvPreauthCC.SetExpDate(expdate); //mandatory for temp token only
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(resCavvPreauthCC);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("DataKey = " + receipt.GetDataKey());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("ResSuccess = " + receipt.GetResSuccess());
Console.WriteLine("PaymentType = " + receipt.GetPaymentType());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
//ResolveData
Console.WriteLine("Cust ID = " + receipt.GetResDataCustId());
Console.WriteLine("Phone = " + receipt.GetResDataPhone());
Console.WriteLine("Email = " + receipt.GetResDataEmail());
November 2018
Page 285 of 486
Moneris Gateway API - Integration Guide
Sample Vault Cavv Purchase
Console.WriteLine("Note = " + receipt.GetResDataNote());
Console.WriteLine("Masked Pan = " + receipt.GetResDataMaskedPan());
Console.WriteLine("Exp Date = " + receipt.GetResDataExpdate());
Console.WriteLine("Crypt Type = " + receipt.GetResDataCryptType());
Console.WriteLine("Avs Street Number = " + receipt.GetResDataAvsStreetNumber());
Console.WriteLine("Avs Street Name = " + receipt.GetResDataAvsStreetName());
Console.WriteLine("Avs Zipcode = " + receipt.GetResDataAvsZipcode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
8.6.9 Vault Cavv Pre-Authorization
Vault Cavv Pre-Authorization transaction object definition
ResCavvPreauthCC resCavvPreauthCC = new ResCavvPreauthCC();
HttpsPostRequest object for Vault Cavv Pre-Authorization
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(resCavvPreauthCC);
Vault Cavv Pre-Authorization transaction details
Table 83: Vault Cavv Pre-Authorization object mandatory values
Value
Type
Limits
Set method
Data Key
String
25-character alphanumeric
resCavvPreauthCC.SetData
(data_key);
Order ID
String
50-character alphanumeric
resCavvPreauthCC.SetOrderId
(order_id);
Amount
String
10-character decimal
resCavvPreauthCC.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Page 286 of 486
November 2018
8 MPI
Table 83: Vault Cavv Pre-Authorization object mandatory values
Value
Type
Limits
Set method
CAVV
String
50-character alphanumeric
resCavvPreauthCC.SetCavv
(cavv);
E-commerce indicator
String
1-character alphanumeric
resCavvPreauthCC.SetCryptType
(crypt);
Table 84: Vault Cavv Pre-Authorization object optional values
Value
Customer ID
Type
String
Limits
50-character
alphanumeric
Set method
resCavvPreauthCC.SetCustId
(cust_id);
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Expiry date
String
4-character numeric
resCavvPreauthCC.SetExpdate
(expiry_date);
Sample Vault Cavv Pre-Authorization
namespace Moneris
{
using System;
using System.Text;
using System.Collections;
public class TestCanadaResCavvPreauthCC
{
public static void Main(string[] args)
{
string store_id = "store1";
string api_token = "yesguy";
string data_key = "4INQR1A8ocxD0oafSz50LADXy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string amount = "1.00";
string cust_id = "customer1"; //if sent will be submitted, otherwise cust_id from profile will be
used
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA";
string expdate = "1911";
string processing_country_code = "CA";
bool status_check = false;
ResCavvPreauthCC resCavvPreauthCC = new ResCavvPreauthCC();
resCavvPreauthCC.SetOrderId(order_id);
resCavvPreauthCC.SetDataKey(data_key);
resCavvPreauthCC.SetCustId(cust_id);
resCavvPreauthCC.SetAmount(amount);
resCavvPreauthCC.SetCavv(cavv);
//resCavvPreauthCC.SetExpDate(expdate); //mandatory for temp token only
November 2018
Page 287 of 486
Moneris Gateway API - Integration Guide
Sample Vault Cavv Pre-Authorization
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(resCavvPreauthCC);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("DataKey = " + receipt.GetDataKey());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("ResSuccess = " + receipt.GetResSuccess());
Console.WriteLine("PaymentType = " + receipt.GetPaymentType());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
//ResolveData
Console.WriteLine("Cust ID = " + receipt.GetResDataCustId());
Console.WriteLine("Phone = " + receipt.GetResDataPhone());
Console.WriteLine("Email = " + receipt.GetResDataEmail());
Console.WriteLine("Note = " + receipt.GetResDataNote());
Console.WriteLine("Masked Pan = " + receipt.GetResDataMaskedPan());
Console.WriteLine("Exp Date = " + receipt.GetResDataExpdate());
Console.WriteLine("Crypt Type = " + receipt.GetResDataCryptType());
Console.WriteLine("Avs Street Number = " + receipt.GetResDataAvsStreetNumber());
Console.WriteLine("Avs Street Name = " + receipt.GetResDataAvsStreetName());
Console.WriteLine("Avs Zipcode = " + receipt.GetResDataAvsZipcode());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
Page 288 of 486
November 2018
9 e-Fraud Tools
l
l
l
9.1 Address Verification Service
9.2 Card Validation Digits (CVD)
9.3 Transaction Risk Management Tool
November 2018
Page 289 of 486
9.1 Address Verification Service
l
l
l
l
9.1.1
9.1.2
9.1.3
9.1.4
About Address Verification Service (AVS)
AVS Info Object
AVS Response Codes
AVS Sample Code
9.1.1 About Address Verification Service (AVS)
Address Verification Service (AVS) is an optional fraud-prevention tool offered by issuing banks whereby a
cardholder's address is submitted as part of the transaction authorization. The AVS address is then compared to the address kept on file at the issuing bank. AVS checks whether the street number, street
name and zip/postal code match. The issuing bank returns an AVS result code indicating whether the
data was matched successfully. Regardless of the AVS result code returned, the credit card is authorized
by the issuing bank.
The response that is received from AVS verification is intended to provide added security and fraud prevention, but the response itself does not affect the completion of a transaction. Upon receiving a
response, the choice to proceed with a transaction is left entirely to the merchant. The responses is not a
strict guideline of whether a transaction will be approved or declined.
The following transactions support AVS:
l
l
l
l
l
Purchase (Basic and Mag Swipe)
Pre-Authorization (Basic)
Re-Authorization (Basic)
ResAddCC (Vault)
ResUpdateCC (Vault)
Things to Consider:
l
l
l
AVS is supported by Visa, MasterCard, American Express, Discover and JCB.
When testing AVS, you must only use the Visa test card numbers 4242424242424242 or
4005554444444403, and the amounts described in the Simulator eFraud Response
Codes document available at the Moneris developer portal (https://developer.moneris.com).
Store ID “store5” is set up to support AVS testing.
9.1.2 AVS Info Object
AVSInfo object definition
AvsInfo avsCheck = new AvsInfo();
November 2018
Page 291 of 486
Moneris Gateway API - Integration Guide
Transaction object set method
.setAvsInfo(avsCheck);
Table 1 AVS Info Object – Required Fields
Variable and Field
Name
AVS street number
Type and Limits
String
Set Method
Description
avsCheck.SetAvsStreetNumber
("212");
Cardholder street
number
avsCheck.SetAvsStreetName
("Payton Street");
Cardholder street
name
avsCheck.SetAvsZipCode
("M1M1M1");
Cardholder zip/postal code
19-character alphanumeric
NOTE: this character limit is a
combined total
allowed for
AVS street number
and AVS street
name
AVS street name
String
19-character alphanumeric
NOTE: this character limit is the
combined total
allowed for
AVS street number
and AVS street
name
AVS zip/postal
code
String
9-character alphanumeric
9.1.3 AVS Response Codes
Below is a full list of possible AVS response codes. These can be returned when you call the
receipt.GetAvsResultCode() method .
Page 292 of 486
November 2018
Table 85: AVS result codes
Value
Visa
MasterCard/Discover
A
Street address matches, zip/postal code
does not. Acquirer rights not implied.
B
Street address matches. Zip/Postal code not N/A
verified due to incompatible formats.
(Acquirer sent both street address and zip/postal code.)
N/A
C
Street address not verified due to incompatible formats. (Acquirer sent both street
address and zip/postal code.)
N/A
N/A
D
Street address and zip/postal code match.
N/A
Customer name incorrect, zip/postal code
matches
E
N/A
N/A
Customer name incorrect, billing address and
zip/postal code match
F
(Applies to UK only) Street address and zip/- N/A
postal code match.
Customer name incorrect, billing address
matches.
G
Address information not verified for international transaction. Any of the following
may be true:
N/A
N/A
l
l
l
Address matches, zip/postal code does not.
Amex/JCB
Billing address
matches, zip/postal
code does not.
Issuer is not an AVS participant.
AVS data was present in the request,
but issuer did not return an AVS result.
Visa performs AVS on behalf of the
issuer and there was no address
record on file for this account.
I
Address information not verified.
N/A
N/A
K
N/A
N/A
Customer name
matches.
L
N/A
N/A
Customer name and
postal code match.
N/A
N/A
Customer name and
zip/postal code match.
November 2018
Page 293 of 486
Moneris Gateway API - Integration Guide
Table 85: AVS result codes (continued)
Value
Visa
MasterCard/Discover
Amex/JCB
M
Street address and zip/postal code match.
N/A
Customer name, billing
address, and zip/postal
code match.
N
No match.
Neither address nor
postal code matches.
Billing address and
postal code do not
match.
Also used when acquirer requests AVS but
sends no AVS data.
O
N/A
N/A
Customer name and
billing address match
P
Postal code matches. Acquirer sent both
postal code and street address, but street
address not verified due to incompatible
formats.
N/A
N/A
R
Retry: System unavailable or timed out.
Issuer ordinarily performs AVS, but was
unavailable.
Retry. System unable to Retry. System unavailprocess.
able.
The code R is used by Visa when issuers are
unavailable. Issuers should refrain from
using this code.
S
N/A
AVS currently not supported.
AVS currently not supported.
T
N/A
Nine-digit zip/postal
code matches, address
does not match.
N/A
U
Address not verified for domestic transaction. One of the following is true:
No data from
Issuer/Authorization
system.
Information is unavailable.
l
l
l
Issuer is not an AVS participant
AVS data was present in the request,
but issuer did not return an AVS result
Visa performs AVS on behalf of the
issuer and there was no address
record on file for this account.
Page 294 of 486
November 2018
Table 85: AVS result codes (continued)
Value
Visa
MasterCard/Discover
Amex/JCB
W
Not applicable. If present, replaced with ‘Z’
by Visa. Available for U.S. issuers only.
For US Addresses, nine- Customer name, billing
digit zip/postal code
address, and zip/postal
matches, address does code are all correct.
not. For addresses outside the US, zip/postal
code matches, address
does not.
X
N/A
For US addresses, nine- N/A
digit zip/postal code
and address match. For
addresses outside the
US,zip/postal code and
address match.
Y
Street address and zip/postal code match.
For US addresses, fivedigit zip/postal code
and address match.
Z
Zip/postal code matches, but street address For U.S. addresses, five- Postal code matches,
either does not match or street address was digit zip code matches, billing address does not
not included in request.
address does not
match.
match.
Billing address and zip/postal code match.
9.1.4 AVS Sample Code
This is a sample of Java code illustrating how AVS is implemented with a Purchase transaction. Purchase
object information that is not relevant to AVS has been removed.
For more about Purchase transactions, see 2.2 Purchase.
Sample Purchase with AVS information
AvsInfo avsCheck = new AvsInfo();
avsCheck.SetAvsStreetNumber("212");
avsCheck.SetAvsStreetName("Payton Street");
avsCheck.SetAvsZipCode("M1M1M1");
avsCheck.SetAvsEmail("test@host.com");
avsCheck.SetAvsHostname("hostname");
avsCheck.SetAvsBrowser("Mozilla");
avsCheck.SetAvsShiptoCountry("CAN");
avsCheck.SetAvsShipMethod("G");
avsCheck.SetAvsMerchProdSku("123456");
avsCheck.SetAvsCustIp("192.168.0.1");
avsCheck.SetAvsCustPhone("5556667777");
Purchase purchase = new Purchase();
purchase.SetAvsInfo(avsCheck);
November 2018
Page 295 of 486
9.2 Card Validation Digits (CVD)
l
l
l
l
9.2.1
9.2.3
9.2.4
9.2.5
About Card Validation Digits (CVD)
CVD Info Object
CVD Result Codes
Sample Purchase with CVD Info Object
9.2.1 About Card Validation Digits (CVD)
The Card Validation Digits (CVD) value is an additional number printed on credit cards that is used as an
additional check when verifying cardholder credentials during a transaction.
The response that is received from CVD verification is intended to provide added security and fraud prevention, but the response itself does not affect the completion of a transaction. Upon receiving a
response, the choice whether to proceed with a transaction is left entirely to the merchant. The
responses is not a strict guideline of which transaction will approve or decline.
The following transactions support CVD:
l
l
l
Purchase (Basic, Vault and Mag Swipe)
Pre-Authorization (Basic and Vault)
Re-Authorization
Things to Consider:
l
l
l
l
CVD is only supported by Visa, MasterCard, American Express, Discover, JCB and
UnionPay.
For UnionPay cards, the CVD response will not be returned; the issuer will approve or
decline based on the CVD result.
When testing CVD, you must only use the Visa test card numbers 4242424242424242 or
4005554444444403, and the amounts described in the Simulator eFraud Response
Codes document available at the Moneris developer portal (https://developer.moneris.com).
Test store_id “store5” is set up to support CVD testing.
9.2.2 Transactions Where CVD Is Required
The Card Validation Digits (CVD) object is required in transaction requests in the following scenarios:
l
l
Initial transactions when storing cardholder credentials in Credential on File scenarios; subsequent
follow-on transactions do not use CVD
Any Purchase, Pre-Authorization or Card Verification where you are not storing cardholder credentials
November 2018
Page 296 of 486
Moneris Gateway API - Integration Guide
9.2.3 CVD Info Object
NOTE: The CVD value must only be passed to the Moneris Gateway. Under no circumstances may it be stored for subsequent uses or displayed as part of the receipt information.
CvdInfo object definition
CvdInfo cvdCheck = new CvdInfo();
Transaction object set method
transaction.setCvdInfo(cvdCheck);
Table 1 CVD Info Object – Required Fields
Variable and Field
Name
CVD indicator
Type and Limits
String
Set Method
cvdCheck.SetCvdIndicator
("1");
1-character
numeric
Description
Indicates presence
of CVD
Possible values:
0: CVD value is deliberately bypassed or is
not provided by the merchant.
1: CVD value is present.
2: CVD value is on the
card, but is illegible.
9: Cardholder states that
the card has no CVD
imprint.
CVD value
String
4-character
numeric
Page 297 of 486
cvdCheck.SetCvdValue
("099");
CVD value located
on credit card
NOTE: The CVD
value must only be
passed to the Moneris Gateway.
Under no circumstances may it
be stored for subsequent uses or displayed as part of
November 2018
Variable and Field
Name
Type and Limits
Set Method
Description
the receipt information.
9.2.4 CVD Result Codes
Value
Definition
M
Match
N
No match
P
Not processed
S
CVD should be on the card, but Merchant has
indicated that CVD is not present
U
Issuer is not a CVD participant
Y
Match for Amex/JCB only
D
Invalid security code for Amex or JCB only
Other
Invalid response code
9.2.5 Sample Purchase with CVD Info Object
This is a sample of Java code illustrating how CVD is implemented with a Purchase transaction. Purchase
object information that is not relevant to CVD has been removed.
Sample Purchase with CVD Information
CvdInfo cvdCheck = new CvdInfo();
cvdCheck.setCvdIndicator("1");
cvdCheck.setCvdValue("099");
Purchase purchase = new Purchase();
purchase.setCvdInfo(cvdCheck);
November 2018
Page 298 of 486
9.3 Transaction Risk Management Tool
l
l
l
l
l
l
9.3.1
9.3.2
9.3.3
9.3.4
9.3.6
9.3.6
About the Transaction Risk Management Tool
Introduction to Queries
Session Query
Attribute Query
Inserting the Profiling Tags Into Your Website
Inserting the Profiling Tags Into Your Website
The Transaction Risk Management Tool (TRMT) is available to Canadian integrations only.
9.3.1 About the Transaction Risk Management Tool
The Transaction Risk Management Tool provides additional information to assist in identifying fraudulent transactions. To maximize the benefits from the Transaction Risk Management Tool, it is highly
recommended that you:
l
l
Carefully consider the business logic and processes that you need to implement surrounding the
handling of response information the Transaction Risk Management Tool provides.
Implement the other fraud tools available through Moneris Gateway (such as AVS, CVD, Verified
by Visa, MasterCard SecureCode and American Express SafeKey).
9.3.2 Introduction to Queries
There are two types of transactions associated with the Transaction Risk Management Tool (TRMT):
l
l
Session Query (page 300)
Attribute Query (page 307)
The Session Query and Attribute Query are used at the time of the transaction to obtain the risk assessment.
Moneris recommends that you use the Session Query as much as possible for obtaining your risk assessment because it uses the device fingerprint as well as other transaction information when providing the
risk scores.
To use the Session Query, you must implement two components:
l
l
Tags on your website to collect the device fingerprinting information
Session Query transaction.
If you are not able to collect the necessary information for the Session Query (such as the device fingerprint), then use the Attribute Query.
November 2018
Canada Only
Page 299 of 486
Moneris Gateway API - Integration Guide
9.3.3 Session Query
Once a device profiling session has been initiated upon a client device, the Session Query API is used at
the time of the transaction or even to obtain a device identifier or ‘fingerprint’, attribute list and risk
assessment for the client device.
Session Query transaction object definition
SessionQuery sq = new SessionQuery();
HttpsPostRequest object for Session Query transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(sq);
Session Query transaction values
Table 86: Session Query transaction object mandatory values
Type
Limits
Set method
Value
Description
Session ID
sq.SetSessionId(session_id);
String 9-character decimal
Permitted characters: [a-z], [A-Z],
0-9, _, -
Web server session identifier generated when device profiling was initiated.
Service type
sq.SetServiceType(service_type);
String 9-character decimal
Which output fields are returned.
session -- returns IP and device related attributes.
Event type
sq.SetEventType(service_type);
String payment
Defines the type of transaction or event for reporting purposes.
payment - Purchasing of goods/services.
Credit card
String 20-character numeric
number (PAN)
No spaces or dashes
sq.SetPan(pan);
Most credit card numbers today are 16 digits, but some 13-digit numbers are still
accepted by some issuers. This field has been intentionally expanded to 20 digits in
consideration for future expansion and potential support of private label card ranges.
Page 300 of 486
Canada Only
November 2018
Table 86: Session Query transaction object mandatory values (continued)
Type
Limits
Set method
Value
Description
sq.SetAccountAddressStreet1
Account
String 32-character alphanumeric
("3300 Bloor St W");
address street
1
First portion of the street address component of the billing address.
sq.SetAccountAddressStreet2("4th
Account
String 32-character alphanumeric
Flr West Tower");
Address street
2
Second portion of the street address component of the billing address.
Account
address city
String 50-character alphanumeric
sq.SetAccountAddressCity
("Toronto");
The city component of the billing address.
sq.SetAccountAddressState
Account
String 64-character alphanumeric
("Ontario");
address state/province
The state/province component of the billing address.
sq.SetAccountAddressCountry
Account
String 2-character alphanumeric
("CA");
address country
ISO2 country code of the billing addresses.
Account
address ZIP/postal code
String 8-character alphanumeric
sq.SetAccountAddressZip
("M8X2X2");
ZIP/postal code of the billing address.
sq.SetAccountAddressStreet1
Shipping
String 32-character alphanumeric
("3300 Bloor St W");
address street
1
First portion of the street address component of the shipping address.
sq.SetAccountAddressStreet2("4th
Shipping
String 32-character alphanumeric
Flr West Tower");
address street
2
Second portion of the street address component of the shipping address.
Shipping
address city
String 50-character alphanumeric
sq.SetAccountAddressCity
("Toronto");
City component of the shipping address.
sq.SetAccountAddressState
Shipping
String 64-character alphanumeric
("Ontario");
address state/province
The state/province component of the shipping address.
November 2018
Canada Only
Page 301 of 486
Moneris Gateway API - Integration Guide
Table 86: Session Query transaction object mandatory values (continued)
Type
Limits
Set method
Value
Description
sq.SetAccountAddressCountry
Shipping
String 2-character alphanumeric
("CA");
address country
ISO2 country code of the account address country.
Shipping
address ZIP
sq.SetAccountAddressZip
("M8X2X2");
String 8-character alphanumeric
The ZIP/postal code component of the shipping address.
sq.SetLocalAttrib1("a");
Local attribute String 255-character alphanumeric
1-5
These five attributes can be used to pass custom attribute data. These are used if you
wish to correlate some data with the returned device information.
Transaction
amount
sq.SetTransactionAmount("1.00");
String 255-character alphanumeric
Must contain 2 decimal places
The numeric currency amount.
Transaction
currency
sq.SetTransactionCurrency
("840");
String 10-character numeric
The currency type that the transaction was denominated in. If TransactionAmount is
passed, the TransactionCurrency is required.
Values to be used are:
l
l
CAD – 124
USD – 840
Table 87: Session Query transaction object optional values
Type
Limits
Set method
Value
Description
Account login
String 255-character
alphanumeric
sq.SetAccountLogin("13195417-8CA0-46cd-960D14C158E4DBB2");
The Account Login name.
Password
hash
String 40-character
alphanumeric
sq.SetPasswordHash
("489c830f10f7c601d30599a0deaf66e64d2aa50a");
The input must be a SHA-2 hash of the password in hexadecimal format. Used to check
if it is on a watch list.
Page 302 of 486
Canada Only
November 2018
Table 87: Session Query transaction object optional values (continued)
Type
Limits
Set method
Value
Description
Account num- String 255-character
alphanumeric
ber
sq.SetAccountNumber("3E17A905-AC8A-4c8d-A4173DADA2A55220");
The account number for the account.
Account name String 255-character
alphanumeric
sq.SetAccountName("4590FCC0-DF4A-44d9-A57BAF9DE98B84DD");
Account name (or concatenation of first and last name of account holder).
Account email String 100-character
alphanumeric
sq.SetAccountEmail("3CAE72EF-6B69-4a25-93FE2674735E78E8@test.threatmetrix.com");
The email address entered into the form for this contact. Used to check if this is a high
risk account email id.
Account telephone
String 32-character
alphanumeric
Contact telephone number including country and city codes. All whitespace is
removed.
Must be in format: 0..9,,(,),[,] braces must be matched.
Address street String 32-character
1
alphanumeric
The first portion of the street address component of the account address.
Address street String 32-character
2
alphanumeric
The second portion of the street address component of the account address.
Address city
String 50-character
alphanumeric
The city component of the account address.
Address state/- String 64-character
province
alphanumeric
The state/province component of the account address
Address coun- String 2-character
try
alphanumeric
The 2 character ISO2 country code of the account address country
November 2018
Canada Only
Page 303 of 486
Moneris Gateway API - Integration Guide
Table 87: Session Query transaction object optional values (continued)
Type
Limits
Set method
Value
Description
Address ZIP
String 8-character
alphanumeric
The ZIP/postal code of the account address.
Ship Address
Street 1
String 32-character
alphanumeric
The first portion of the street address component of the shipping address
Ship Address
Street 2
String 32-character
alphanumeric
The second portion of the street address component of the shipping address
Ship Address
City
String 50-character
alphanumeric
The city component of the shipping address
Ship Address String 64-character
State/Province
alphanumeric
The state/province component of the shipping address
Ship Address
Country
String 2-character
alphanumeric
The 2 character ISO2 country code of the shipping address country
Ship Address
ZIP
String 8-character
alphanumeric
The ZIP/postal code of the shipping address
CC Number
Hash
String 255-character
alphanumeric
This is a SHA-2 hash (in hexadecimal format) of the credit card number.
Custom Attrib- String 255-character
ute 1-8
alphanumeric
These 8 attributes can be used to pass custom attribute data which can be used within
the rules.
Page 304 of 486
Canada Only
November 2018
Sample Session Query - CA
namespace Moneris
{
using System;
using System.Collections;
public class TestCanadaRiskCheckSession
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string session_id = "abc123";
string service_type = "session";
//string event_type = "LOGIN";
string processing_country_code = "CA";
bool status_check = false;
SessionQuery sq = new SessionQuery();
sq.SetOrderId(order_id);
sq.SetSessionId(session_id);
sq.SetServiceType(service_type);
sq.SetEventType(service_type);
//sq.SetPolicy("");
//sq.SetDeviceId("4EC40DE5-0770-4fa0-BE53-981C067C598D");
sq.SetAccountLogin("13195417-8CA0-46cd-960D-14C158E4DBB2");
sq.SetPasswordHash("489c830f10f7c601d30599a0deaf66e64d2aa50a");
sq.SetAccountNumber("3E17A905-AC8A-4c8d-A417-3DADA2A55220");
sq.SetAccountName("4590FCC0-DF4A-44d9-A57B-AF9DE98B84DD");
sq.SetAccountEmail("3CAE72EF-6B69-4a25-93FE-2674735E78E8@test.threatmetrix.com");
//sq.SetAccountTelephone("5556667777");
sq.SetPan("4242424242424242");
//sq.SetAccountAddressStreet1("3300 Bloor St W");
//sq.SetAccountAddressStreet2("4th Flr West Tower");
//sq.SetAccountAddressCity("Toronto");
//sq.SetAccountAddressState("Ontario");
//sq.SetAccountAddressCountry("CA");
//sq.SetAccountAddressZip("M8X2X2");
//sq.SetShippingAddressStreet1("3300 Bloor St W");
//sq.SetShippingAddressStreet2("4th Flr West Tower");
//sq.SetShippingAddressCity("Toronto");
//sq.SetShippingAddressState("Ontario");
//sq.SetShippingAddressCountry("CA");
//sq.SetShippingAddressZip("M8X2X2");
//sq.SetLocalAttrib1("a");
//sq.SetLocalAttrib2("b");
//sq.SetLocalAttrib3("c");
//sq.SetLocalAttrib4("d");
//sq.SetLocalAttrib5("e");
//sq.SetTransactionAmount("1.00");
//sq.SetTransactionCurrency("840");
//set SessionAccountInfo
sq.SetTransactionCurrency("CAN");
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(sq);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
November 2018
Canada Only
Page 305 of 486
Moneris Gateway API - Integration Guide
Sample Session Query - CA
try
{
Hashtable results = new Hashtable();
string[] rules;
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
// results = receipt.GetResult();
//Iterate through the response
// IDictionaryEnumerator r = results.GetEnumerator();
// while (r.MoveNext())
// {
// Console.WriteLine(r.Key.ToString() + " = " + r.Value.ToString());
// }
//Iterate through the rules that were fired
rules = receipt.GetRules();
for (int i = 0; i < rules.Length; i++)
{
Console.WriteLine("RuleName = " + rules[i]);
Console.WriteLine("RuleCode = " + receipt.GetRuleCode(rules[i]));
Console.WriteLine("RuleMessageEn = " + receipt.GetRuleMessageEn(rules[i]));
Console.WriteLine("RuleMessageFr = " + receipt.GetRuleMessageFr(rules[i]));
}
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
} // end TestRiskCheckSession
}
9.3.3.1 Session Query Transaction Flow
Figure 4: Session Query transaction flow
1. Cardholder logs onto the merchant website.
2. When the page has loaded in the cardholder's browser, special tags within the site allow information from the device to be gathered and sent to ThreatMetrix as the device fingerprint.
The HTML tags should be placed where the cardholder is resident on the page for a couple of
seconds to get the broadest data possible.
3. Customer submits a transaction.
Page 306 of 486
Canada Only
November 2018
4. Merchant’s web application makes a Session Query transaction to the Moneris Gateway using
the same session id that was included in the device fingerprint. This call must be made within 30
minutes of profiling (2).
5. Moneris Gateway submits the Session Query data to ThreatMetrix.
6. ThreatMetrix uses the Session Query data and the device fingerprint information to assess the
transaction against the rules. A score is generated based on the rules.
7. The merchant uses the returned device information in its risk analysis to make a business
decision. The merchant may wish to continue or cancel with the cardholder’s payment transaction.
9.3.4 Attribute Query
The Attribute Query is used to obtain a risk assessment of transaction-related identifiers such as the
email address and the card number. Unlike the Session Query, the Attribute Query does not require the
device fingerprinting information to be provided.
AttributeQuery transaction object definition
AttributeQuery aq = new AttributeQuery();
HttpsPostRequest object for AttributeQuery transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
Attribute Query transaction values
Table 88: Attribute Query transaction object mandatory values
Type
Limits
Set method
Value
Description
Service type
aq.SetServiceType(service_type);
String N/A
Which output fields are returned.
session -- returns IP and device related attributes.
Device ID
String 36-character alphanumeric
aq.SetDeviceId("");
Unique device identifier generated by a previous call to the ThreatMetrix sessionquery API.
Credit card
number
String 20-character numeric
aq.SetPan(pan);
No spaces or dashes
Most credit card numbers today are 16 digits, but some 13-digit numbers are still
accepted by some issuers. This field has been intentionally expanded to 20 digits in
consideration for future expansion and potential support of private label card ranges.
November 2018
Canada Only
Page 307 of 486
Moneris Gateway API - Integration Guide
Table 88: Attribute Query transaction object mandatory values (continued)
Type
Limits
Set method
Value
Description
IP address
String 64-character alphanumeric
aq.SetIPAddress("192.168.0.1");
True IP address. Results will be returned as true_ip_geo, true_ip_score and so on.
IP forwarded
String 64-character alphanumeric
aq.SetIPForwarded
("192.168.1.0");
The IP address of the proxy. If the IPAddress is supplied, results will be returned as
proxy_ip_geo and proxy_ip_score.
If the IP Address is not supplied, this IP address will be treated as the true IP address
and results will be returned as true_ip_geo, true_ip_score and so on
aq.SetAccountAddressStreet1
Account
String 32-character alphanumeric
("3300 Bloor St W");
address street
1
First portion of the street address component of the billing address.
aq.SetAccountAddressStreet2("4th
Account
String 32-character alphanumeric
Flr West Tower");
Address Street
2
Second portion of the street address component of the billing address.
Account
address city
String 50-character alphanumeric
aq.SetAccountAddressCity
("Toronto");
The city component of the billing address.
aq.SetAccountAddressState
Account
String 64-character alphanumeric
("Ontario");
address state/province
The state component of the billing address.
aq.SetAccountAddressCountry
Account
String 2-character alphanumeric
("CA");
address country
ISO2 country code of the billing addresses.
Account
address zip/postal code
String 8-character alphanumeric
aq.SetAccountAddressZip
("M8X2X2");
Zip/postal code of the billing address.
Shipping
String 32-character alphanumeric
address street
1
Account address country
aq.SetShippingAddressStreet1
("3300 Bloor St W");
aq.SetShippingAddressStreet2
Shipping
String 32-character alphanumeric
("4th Flr West Tower");
Address Street
2
Second portion of the street address component of the shipping address.
Page 308 of 486
Canada Only
November 2018
Table 88: Attribute Query transaction object mandatory values (continued)
Type
Limits
Set method
Value
Description
Shipping
Address City
String 50-character alphanumeric
aq.setShippingAddressCity
("Toronto");
City component of the shipping address.
aq.setShippingAddressState
Shipping
String 64-character alphanumeric
("Ontario");
Address
State/Province State/Province component of the shipping address.
aq.setShippingAddressCountry
Shipping
String 2-character alphanumeric
("CA");
Address Country
ISO2 country code of the account address country.
Shipping
Address zip/postal code
String 8-character alphanumeric
The zip/postal code component of the shipping address.
Sample Attribute Query
namespace Moneris
{
using System;
using System.Collections;
public class TestRiskCheckAttribute
{
public static void Main(string[] args)
{
string store_id = "moneris";
string api_token = "hurgle";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string service_type = "session";
string processing_country_code = "CA";
bool status_check = false;
AttributeQuery aq = new AttributeQuery();
aq.SetOrderId(order_id);
aq.SetServiceType(service_type);
aq.setDeviceId("");
aq.setAccountLogin("13195417-8CA0-46cd-960D-14C158E4DBB2");
aq.setPasswordHash("489c830f10f7c601d30599a0deaf66e64d2aa50a");
aq.setAccountNumber("3E17A905-AC8A-4c8d-A417-3DADA2A55220");
aq.setAccountName("4590FCC0-DF4A-44d9-A57B-AF9DE98B84DD");
aq.setAccountEmail("3CAE72EF-6B69-4a25-93FE-2674735E78E8@test.threatmetrix.com");
//aq.setCCNumberHash("4242424242424242");
//aq.setIPAddress("192.168.0.1");
//aq.setIPForwarded("192.168.1.0");
aq.setAccountAddressStreet1("3300 Bloor St W");
aq.setAccountAddressStreet2("4th Flr West Tower");
aq.setAccountAddressCity("Toronto");
aq.setAccountAddressState("Ontario");
aq.setAccountAddressCountry("CA");
aq.setAccountAddressZip("M8X2X2");
November 2018
Canada Only
Page 309 of 486
Moneris Gateway API - Integration Guide
Sample Attribute Query
aq.setShippingAddressStreet1("3300 Bloor St W");
aq.setShippingAddressStreet2("4th Flr West Tower");
aq.setShippingAddressCity("Toronto");
aq.setShippingAddressState("Ontario");
aq.setShippingAddressCountry("CA");
aq.setShippingAddressZip("M8X2X2");
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(aq);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Hashtable results = new Hashtable();
string[] rules;
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
results = receipt.GetResult();
//Iterate through the response
IDictionaryEnumerator response = results.GetEnumerator();
while (response.MoveNext())
{
Console.WriteLine(response.Key.ToString() + " = " + response.Value.ToString());
}
//Iterate through the rules that were fired
rules = receipt.GetRules();
for (int i = 0; i < rules.Length; i++)
{
Console.WriteLine("RuleName = " + rules[i]);
Console.WriteLine("RuleCode = " + receipt.GetRuleCode(rules[i]));
Console.WriteLine("RuleMessageEn = " + receipt.GetRuleMessageEn(rules[i]));
Console.WriteLine("RuleMessageFr = " + receipt.GetRuleMessageFr(rules[i]));
}
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
} // end TestRiskCheckAttribute
}
Page 310 of 486
Canada Only
November 2018
9.3.4.1 Attribute Query Transaction Flow
Figure 5: Attribute query transaction flow
1. Cardholder logs onto merchant website and submits a transaction.
2. The merchant’s web application makes an Attribute Query transaction that includes the session
ID to the Moneris Gateway.
3. Moneris Gateway submits Attribute Query data to ThreatMetrix.
4. ThreatMetrix uses the Attribute Query data to assess the transaction against the rules. A score is
generated based on the rules.
5. The merchant uses the returned device information in its risk analysis to make a business
decision. The merchant may wish to continue or cancel with the cardholder's payment transaction.
9.3.5 Handling Response Information
When reviewing the response information and determining how to handle the transaction, it is recommended that you (either manually or through automated logic on your site) use the following pieces of
information:
l
l
l
l
Risk score
Rules triggered (such as Rule Codes, Rule Names, Rule Messages)
Results obtained from Verified by Visa, MasterCard Secure Code, AVS, CVD and the financial transaction authorization
Response codes for the Transaction Risk Management Transaction that are included by automated processes.
November 2018
Canada Only
Page 311 of 486
Moneris Gateway API - Integration Guide
9.3.5.1 TRMT Response Fields
Table 89: Receipt object response values for TRMT
Type
Limits
Get method
Value
Definition
Response
Code
String
receipt.GetResponseCode();
3-character alphanumeric
001 – Success
981 – Data error
982 – Duplicate Order ID
983 – Invalid Transaction
984 – Previously asserted
985 – Invalid activity description
986- Invalid impact description
987 – Invalid Confidence description
988 - Cannot find Previous
Message
String
N/A
receipt.GetMessage();
Response message
Event type
String
N/A
Type of transaction or event returned in the response.
Org ID
String
N/A
ThreatMetrix-defined unique transaction identifier
Policy
String
N/A
Policy used for the Session Query will be returned with the return request. If the Policy
was not included, then the Policy name default is returned.
Policy score
String
N/A
The sum of all the risks weights from triggered rules within the selected policy in the
range [-100…100]
Request dur- String
N/A
ation
Length of time it takes for the transaction to be processed.
Page 312 of 486
Canada Only
November 2018
Table 89: Receipt object response values for TRMT (continued)
Type
Limits
Get method
Value
Definition
Request ID
String
N/A
Unique number and will always be returned with the return request.
Request res- String
N/A
ult
See 9.3.5.1 (page 312).
Review
status
String
Risk rating
String
N/A
The transaction status based on the assessments and risk scores.
N/A
The rating based on the assessments and risk scores.
Service type String
N/A
The service type will be returned in the attribute query response.
Session ID
String
N/A
Temporary identifier unique to the visitor will be returned in the return request.
Summary
risk score
String
Transaction
ID
String
Unknown
session
String
N/A
Based on all of the returned values in the range [-100 … 100]
N/A
This is the transaction identifier and will always be returned in the response when supplied as input.
N/A
If present, the value is "yes". It indicates the session ID that was passed was not found.
Table 90: Response code descriptions
Value
November 2018
Definition
001
Success
981
Data error
982
Duplicate order ID
983
Invalid transaction
984
Previously asserted
985
Invalid activity description
Canada Only
Page 313 of 486
Moneris Gateway API - Integration Guide
Value
Definition
986
Invalid impact description
987
Invalid confidence description
988
Cannot find previous
Table 91: Request result values and descriptions
Value
Definition
fail_duplicate_entities_of_same_type
More than one entity of the same was specified,
e.g. password_hash was specified twice.
fail_incomplete
ThreatMetrix was unable to process the request
due to incomplete or incorrect input data
fail_invalid_account_number
The format of the supplied account number was
invalid
fail_invalid_characters
Invalid characters submitted
fail_invalid_charset
The value of character set was invalid
fail_invalid_currency_code
The format of the currency_code was invalid
fail_invalid_currency_format
The format of the currency_format was invalid
fail_invalid_telephone_number
Format of the supplied telephone number was
invalid
fail_access
ThreatMetrix was unable to process the request
because of API verification failing
fail_internal_error
ThreatMetrix encountered an error while processing the request
fail_invalid_device_id
Format of the supplied device_id was invalid
fail_invalid_email_address
Format of the supplied email address was invalid
fail_invalid_fuzzy_device_id
The format of fuzzy_device_id was invalid
fail_invalid_ip_address_parameter
Format of a supplied ip_address parameter was
invalid
fail_invalid_parameter
The format of the parameter was invalid, or the
Page 314 of 486
Canada Only
November 2018
Value
Definition
value is out of boundary
fail_invalid_sha_hash
The format of a parameter specified as a sha hash
was invalid, sha hash included sha1/2/3 hash
fail_invalid_submitter_id
The format of the submitter id was invalid or the
value is out of boundary
fail_no_policy_configured
No policy was configured against the org_id
fail_not_enough_params
Not enough device attributes were collected during profiling to perform a fingerprint match
fail_parameter_overlength
The value of the parameter was overlength
fail_temporarily_unavailable
Request failed because the service is temporarily
unavailable
fail_too_many_instances_of_same_parameter
Multiple values for some parameters which only
allow one instance
fail_verification
API query limit reached
success
ThreatMetrix was able to process the request successfully
9.3.5.2 Understanding the Risk Score
For each Session Query or Attribute Query, a score with a value between -100 and +100 is returned based
on the rules that were triggered for the transaction.
Table 92 defines the risk scores ranges.
Table 92: Session Query and Attribute Query risk score definitions
Risk score
Visa definition
-100 to -1
A lower score indicates a higher probability that the transaction is fraudulent.
0
Neutral transaction
1 to 100
A higher score indicates a lower probability that the transaction is fraudulent.
Note: All e-commerce transactions have some level of risk associated with them.
Therefore, it is rare to see risk score in the high positive values.
November 2018
Canada Only
Page 315 of 486
Moneris Gateway API - Integration Guide
When evaluating the risk of a transaction, the risk score gives an initial indicator of the potential risk that
the transaction is fraudulent. Because some of the rules that are evaluated on each transaction may not
be relevant to your business scenario, review the rules that were triggered for the transaction before
determining how to handle the transaction.
9.3.5.3 Understanding the Rule Codes, Rule Names and Rule Messages
The rule codes, rule names and rule messages provide details about what rules were triggered during the
assessment of the information provided in the Session or Attribute Query. Each rule code has a rule
name and rule message. The rule name and rule message are typically similar. Table 93 provides additional information on each rule.
When evaluating the risk of a transaction, it is recommended that you review the rules that were
triggered for the transaction and assess the relevance to your business. (That is, how does it relate to the
typical buying habits of your customer base?)
If you are automating some or all of the decision-making processes related to handling the responses,
you may want to use the rule codes. If you are documenting manual processes, you may want to refer to
the more user-friendly rule name or rule message.
Table 93: Rule names, numbers and messages
Rule name
Rule number
Rule message
Rule explanation
White lists
DeviceWhitelisted
WL001
Device White Listed
Device is on the white list. This indicates that the device has
been flagged as always "ok".
Note: This rule is currently not in use.
IPWhitelisted
WL002
IP White Listed
IP address is on the white list. This indicates the device has
been flagged as always "ok".
Note: This rule is currently not in use.
EmailWhitelisted
WL003
Email White Listed
Email address is on the white list. This indicates that the
device has been flagged as always "ok".
Note: This rule is currently not in use.
Event velocity
2DevicePayment
EV003
2 Device Payment Velocity
Multiple payments were detected from this device in the
past 24 hours.
Page 316 of 486
Canada Only
November 2018
Table 93: Rule names, numbers and messages (continued)
Rule name
2IPPaymentVelocity
Rule number
Rule message
Rule explanation
EV006
2 IP Payment Velocity
Multiple payments were detected from this IP within the
past 24 hours.
2ProxyPaymentVelocity
EV008
2 Proxy Payment Velocity
The device has used 3 or more different proxies during a 24
hour period. This could be a risk or it could be someone
using a legitimate corporate proxy.
Email
3EmailPerDeviceDay
EM001
3 Emails for the Device ID in 1 Day
This device has presented 3 different email IDs within the
past 24 hours.
3EmailPerDeviceWeek
EM002
3 emails for the Device ID in 1 week
This device has presented 3 different email IDs within the
past week.
3DevciePerEmailDay
EM003
3 Device Ids for email address in 1 day
This email has been presented from three different devices
in the past 24 hours.
3DevciePerEmailWeek
EM004
3 Device Ids for email address in 1 week
This email has been presented from three different devices
in the past week.
EmailDistanceTravelled
EM005
Email Distance Travelled
This email address has been associated with different physical locations in a short period of time.
3EmailPerSmartIDHour
EM006
3 Emails for SmartID in 1 Hour
The SmartID for this device has been associated with 3 different email addresses in 1 hour.
GlobalEMailOverOneMonth
EM007
Global Email over 1 month
The e-mail address involved in the transaction over 30 days
ago. This generally indicates that the transaction is less
risky.
Note: This rule is set so that it does not impact the policy
score or risk rating.
ComputerGeneratedEmailAddress
November 2018
EM008
Canada Only
Computer Generated Email Address
Page 317 of 486
Moneris Gateway API - Integration Guide
Table 93: Rule names, numbers and messages (continued)
Rule name
Rule number
Rule message
Rule explanation
This transaction used a computer-generated email address.
Account Number
3AccountNumberPerDeviceDay
AN001
3 Account Numbers for device in 1 day
This device has presented 3 different user accounts within
the past 24 hours.
3AccountNumberPerDeviceWeek
AN002
3 Account Numbers for device in 1
week
This device has presented 3 different user accounts within
the past week.
3DevciePerAccountNumberDay
AN003
3 Device IDs for account number in 1
day
This user account been used from three different devices in
the past 24 hours.
3DevciePerAccountNumberWeek
AN004
3 Device IDs for account number in 1
week
This card number has been used from three different
devices in the past week.
AccountNumberDistanceTravelled
AN005
Account Number distance travelled
This card number has been used from a number of physically different locations in a short period of time.
Credit card/payments
3CreditCardPerDeviceDay
CP001
3 credit cards for device in 1 day
This device has used three credit cards within 24 hours.
3CreditCardPerDeviceWeek
CP002
3 credit cards for device in 1 week
This device has used three credit cards within 1 week.
3DevicePerCreditCardDay
CP003
3 device ids for credit card in 1 day
This credit card has been used on three different devices in
24 hours.
3DevciePerCreditCardWeek
CP004
3 device ids for credit card in 1 week
This credit card has been used on three different devices in 1
week.
Page 318 of 486
Canada Only
November 2018
Table 93: Rule names, numbers and messages (continued)
Rule name
CredtCardDistanceTravelled
Rule number
Rule message
Rule explanation
CP005
Credit Card has travelled
The credit card has been used at a number of physically different locations in a short period of time.
CreditCardShipAddressGeoMismatch
CP006
Credit Card and Ship Address do not
match
The credit card was issued in a region different from the Ship
To Address information provided.
CreditCardBillAddressGeoMismatch
CP007
Credit Card and Billing Address do not
match
The credit card was issued in a region different from the
Billing Address information provided.
CreditCardDeviceGeoMismatch
CP008
Credit Card and device location do not
match
The device is located in a region different from where the
card was issued.
CreditCardBINShipAddressGeoMismatch CP009
Credit Card issuing location and Shipping address do not match
The credit card was issued in a region different from the Ship
To Address information provided.
CreditCardBINBillAddressGeoMismatch
CP010
Credit Card issuing location and Billing
address do not match
The credit card was issued in a region different from the
Billing Address information provided.
CreditCardBINDeviceGeoMismatch
CP011
Credit Card issuing location and location of the device do not match
The device is located in a region different from where the
card was issued.
TransactionValueDay
CP012
Daily Transaction Value Threshold
The transaction value exceeds the daily threshold.
TransactionValueWeek
CP013
Weekly Transaction Value Threshold
The transaction value exceeds the weekly threshold.
Proxy rules
3ProxyPerDeviceDay
PX001
3 Proxy Ips in 1 day
This device has used three different proxy servers in the past
24 hours.
November 2018
Canada Only
Page 319 of 486
Moneris Gateway API - Integration Guide
Table 93: Rule names, numbers and messages (continued)
Rule name
AnonymousProxy
Rule number
Rule message
Rule explanation
PX002
Anonymous Proxy IP
This device is using an anonymous proxy
UnusualProxyAttributes
PX003
Unusual Proxy Attributes
This transaction is coming from a source with unusual proxy
attributes.
AnonymousProxy
PX004
Anonymous Proxy
This device is connecting through an anonymous proxy connection.
HiddenProxy
PX005
Hidden Proxy
This device is connecting via a hidden proxy server.
OpenProxy
PX006
Open Proxy
This transaction is coming from a source that is using an
open proxy.
TransparentProxy
PX007
Transparent Proxy
This transaction is coming from a source that is using a transparent proxy.
DeviceProxyGeoMismatch
PX008
Proxy and True GEO Match
This device is connecting through a proxy server that didn’t
match the devices geo-location.
ProxyTrueISPMismatch
PX009
Proxy and True ISP Match
This device is connecting through a proxy server that
doesn’t match the true IP address of the device.
ProxyTrueOrganizationMismatch
PX010
Proxy and True Org Match
The Proxy information and True ISP information for this
source do not match.
DeviceProxyRegionMismatch
PX011
Proxy and True Region Match
The proxy and device region location information do not
match.
ProxyNegativeReputation
PX012
Proxy IP Flagged Risky in Reputation
Network
This device is connecting from a proxy server with a known
negative reputation.
Page 320 of 486
Canada Only
November 2018
Table 93: Rule names, numbers and messages (continued)
Rule name
SatelliteProxyISP
Rule number
Rule message
Rule explanation
PX013
Satellite Proxy
This transaction is coming from a source that is using a satellite proxy.
GEO
DeviceCountriesNotAllowed
GE001
True GEO in Countries Not Allowed
blacklist
This device is connecting from a high-risk geographic location.
DeviceCountriesNotAllowed
GE002
True GEO in Countries Not Allowed
(negative whitelist)
The device is from a region that is not on the whitelist of
regions that are accepted.
DeviceProxyGeoMismatch
GE003
True GEO different from Proxy GEO
The true geographical location of this device is different from
the proxy geographical location.
DeviceAccountGeoMismatch
GE004
Account Address different from True
GEO
This device has presented an account billing address that
doesn't match the devices geolocation.
DeviceShipGeoMismatch
GE005
Device and Ship Geo mismatch
The location of the device and the shipping address do not
match.
DeviceShipGeoMismatch
GE006
Device and Ship Geo mismatch
The location of the device and the shipping address do not
match.
Device
SatelliteISP
DV001
Satellite ISP
This transaction is from a source that is using a satellite ISP.
MidsessionChange
DV002
Session Changed Mid-session
This device changed session details and identifiers in the
middle of a session.
November 2018
Canada Only
Page 321 of 486
Moneris Gateway API - Integration Guide
Table 93: Rule names, numbers and messages (continued)
Rule name
LanguageMismatch
Rule number
Rule message
Rule explanation
DV003
Language Mismatch
The language of the user does not match the primary language spoken in the location where the True IP is registered.
NoDeviceID
DV004
No Device ID
No device ID was available for this transaction.
Dial-upConnection
DV005
Dial-up connection
This device uses a less identifiable dial-up connection.
DeviceNegativeReputation
DV006
Device Blacklisted in Reputational Network
This device has a known negative reputation as reported to
the fraud network.
DeviceGlobalBlacklist
DV007
Device on the Global Black List
This device has been flagged on the global blacklist of known
problem devices.
DeviceCompromisedDay
DV008
Device compromised in last day
This device has been reported as compromised in the last 24
hours.
DeviceCompromisedHour
DV009
Device compromised in last hour
This device has been reported as compromised in the last
hour.
FlashImagesCookiesDisabled
DV010
Flash Images Cookies Disabled
Key browser functions/identifiers have been disabled on
this device.
FlashCookiesDisabled
DV011
Flash Cookies Disabled
Key browser functions/identifiers have been disabled on
this device.
FlashDisabled
DV012
Flash Disabled
Key browser functions/identifiers have been disabled on
this device.
ImagesDisabled
DV013
Images Disabled
Key browser functions/identifiers have been disabled on
this device.
Page 322 of 486
Canada Only
November 2018
Table 93: Rule names, numbers and messages (continued)
Rule number
Rule name
Rule message
Rule explanation
CookiesDisabled
DV014
Cookies Disabled
Key browser functions/identifiers have been disabled on
this device.
DeviceDistanceTravelled
DV015
Device Distance Travelled
The device has been used from multiple physical locations in
a short period of time.
PossibleCookieWiping
DV016
Cookie Wiping
This device appears to be deleting cookies after each session.
PossibleCookieCopying
DV017
Possible Cookie Copying
This device appears to be copying cookies.
PossibleVPNConnection
DV018
Possibly using a VPN Connection
This device may be using a VPN connection
9.3.5.4 Examples of Risk Response
Session Query
Sample Risk Response - Session Query
001Successabc123yespaymentsession-25riskcheck4211kue09691C1879B-33D4-4D72-8FCB-B60A172B3CACmediumsuccess-25defaultreviewComputerGeneratedEMailUN001
November 2018
Canada Only
Page 323 of 486
Moneris Gateway API - Integration Guide
Sample Risk Response - Session Query
Unknown RuleRegle InconnusNoDeviceIDDV004No Device IDnull
Attribute Query
Sample Risk Response - Attribute Query
11kue096443D7FB5-CC5C-4917-A57E-27EAC824069Csessionmedium-25successdefault-25riskcheck19reviewComputerGeneratedEMailUN001Unknown RuleRegle InconnusNoDeviceIDDV004No Device IDnull
9.3.6 Inserting the Profiling Tags Into Your Website
Place the profiling tags on an HTML page served by your web application such that ThreatMetrix can collect device information from the customer’s web browser. The tags must be placed on a page that a visitor would display in a browser window for 3-5 seconds (such as a page that requires a user to input
Page 324 of 486
Canada Only
November 2018
data). After the device is profiled, a Session Query may be used to obtain the detail device information
for risk assessment before submitting a financial payment transaction.
There are two profiling tags that require two variables. Those tags are org_id and session_id. session_id must match the session ID value that is to be passed in the Session Query transaction. The
valid org_id values are:
11kue096
QA testing environment.
lbhqgx47
Production environment.
Below is an HTML sample of the profiling tags.
NOTE: Your site must replace in the sample code with a unique alphanumeric value each time you fingerprint a new customer.
File Type : PDF
File Type Extension : pdf
MIME Type : application/pdf
PDF Version : 1.4
Linearized : No
Page Count : 486
Page Mode : UseOutlines
Page Layout : SinglePage
Language : en-us
Producer : madbuild
Create Date : 2018:11:27 16:59:25-05:00
Modify Date : 2018:11:27 16:59:25-05:00
Title : My Document
Author : michael.pukin
Subject :
.
November 2018
Canada Only
Page 325 of 486
9.4 Encorporating All Available Fraud Tools
l
l
l
9.4.1 Implementation Options for TRMT
9.4.2 Implementation Checklist
9.4.3 Making a Decision
To minimize fraudulent activity in online transactions, Moneris recommends that you implement all of
the fraud tools available through the Moneris Gateway. These are explained below:
Address Verification Service (AVS)
Verifies the cardholder's billing address information.
Verified by Visa, MasterCard Secure Code and Amex SafeKey (VbV/MCSC/SafeKey)
Authenticates the cardholder at the time of an online transaction.
Card Validation Digit (CVD)
Validates that cardholder is in possession of a genuine credit card during the transaction.
Note that all responses that are returned from these verification methods are intended to provide added
security and fraud prevention. The response itself does not affect the completion of a transaction. Upon
receiving a response, the choice to proceed with a transaction is left entirely to the merchant.
9.4.1 Implementation Options for TRMT
Option A
Process a Transaction Risk Management Tool query and obtain the response. You can then decide
whether to continue with the transaction, abort the transaction, or use additional efraud features.
If you want to use additional efraud features, perform one or both of the following to help make your
decision about whether to continue with the transaction or abort it:
l
l
Process a VbV/MCSC/SafeKey transaction and obtain the response. The merchant then makes the
decision whether to continue with the transaction or to abort it.
Process a financial transaction including AVS/CVD details and obtain the response. The merchant
then makes a decision whether to continue with the transaction or to abort it.
Option B
1.
2.
3.
4.
Process a Transaction Risk Management Tool query and obtain the response.
Process a VbV/MCSC/SafeKey transaction and obtain the response.
Process a financial transaction including AVS/CVD details and obtain the response.
Merchant then makes a one-time decision based on the responses received from the eFraud
tools.
9.4.2 Implementation Checklist
The following checklists provide high-level tasks that are required as part of your implementation of the
Transaction Risk Management Tool. Because each organization has certain project requirements for
implementing system and process changes, this list is only a guideline, and does not cover all aspects of
your project.
November 2018
Page 326 of 486
Moneris Gateway API - Integration Guide
Download and review all of the applicable APIs and Integration Guides
Please review the sections outlined within this document that refers to the following feature
Table 94: API documentation
Document/API
Use the document if you are….
Transaction Risk Management Tool Integration
Guide (Section #)
Implementing or updating your integration for the
Transaction Risk Management Tool
Moneris MPI – Verified by Visa/MasterCard
SecureCode/American Express SafeKey – Java API
Integration Guide
Implementing or updating Verified by Visa, MasterCard SecureCode or American Express SafeKey
Basic transaction with VS and CVD (Section#)
Implementing or updating transaction processing,
AVS or CVD
Design your transaction flow and business processes
When designing your transaction flow, think about which scenarios you would like to have automated,
and which scenarios you would like to have handled manually by your employees.
The “Understand Transaction Risk Management Transaction Flow” and Handling Response Information
(page 311) sections can help you work through the design of your transaction and process flows.
Things to consider when designing your process flows:
l
l
l
Processes for notifying people within your organization when there is scheduled maintenance for
Moneris Gateway.
Handling refunds, canceled orders and so on.
Communicating with customers when you will not be shipping the goods because of suspected
fraud, back-ordered goods and so on.
Complete your development and testing
l
The Moneris Gateway API - Integration Guide provides the technical details required for the development and testing. Ensure that you follow the testing instructions and data provided.
If you are an integrator
l
l
l
Ensure that your solution meets the requirements for PCI-DSS/PA-DSS as applicable.
Send an email to eproducts@moneris.com with the subject line “Certification Request”.
Develop material to set up your customers as quickly as possible with your solution and a Moneris
account. Include information such as:
l Steps they must take to enter their store ID or API token information into your solution.
Page 327 of 486
November 2018
l
Any optional services that you support via Moneris Gateway (such as TRMT, AVS, CVD,
VBV/MCSC/SafeKey and so on) so that customers can request these features.
9.4.3 Making a Decision
Depending on your business policies and processes, the information obtained from the fraud tools (such
as AVS, CVD, VbV/MCSC/SafeKey and TRMT) can help you make an informed decision about whether to
accept a transaction or deny it because it is potentially fraudulent.
If you do not want to continue with a likely fraudulent transaction, you must inform the customer that
you are not proceeding with their transaction.
If you are attempting to do further authentication by using the available fraud tools, but you have
received an approval response instead, cancel the financial transaction by doing one of the following:
l
l
If the original transaction is a Purchase, use a Purchase Correction or Refund transaction. You will
need the original order ID and transaction number.
If the original transaction is a Pre-Authorization, use a Completion transaction for $0.00.
November 2018
Page 328 of 486
10 Apple Pay In-App and on the Web Integration
l
l
l
l
l
10.1 About Apple Pay In-App and on the Web Integration10.1 About Apple Pay In-App and on the
Web Integration
10.2 About API Integration of Apple Pay
10.3 Apple Pay In-App Process Flows10.3 Apple Pay In-App Process Flows
10.4 Cavv Purchase – Apple Pay 10.4 Cavv Purchase – Apple Pay
10.5 Cavv Pre-Authorization – Apple Pay
10.1 About Apple Pay In-App and on the Web Integration
The Moneris Gateway enables merchants to process in-app or on the web payment methods in mobile
applications and the Safari web browser on Apple devices via Apple Pay.
Moneris Solutions offers two processing and integration methods for Apple Pay. Merchants can choose
to use one of two methods:
l
l
Software Development Kit (SDK), or
API
While both methods provide the same basic payment features, there are differences in their implementations.
This guide only deals with the API method; for detailed information about the SDK method of integration, see the Moneris Developer Portal at https://developer.moneris.com.
10.2 About API Integration of Apple Pay
An API integration works to provide a communication link between the merchants’ server and Moneris’
server. APIs are required to complete any transaction, and therefore the APIs for Apple Pay are also
included within an SDK integration.
If the merchant chooses to use only an API integration, the merchant must decrypt payload information
themselves before sending the decrypted information to the Moneris Gateway to be processed. Because
this process is complicated, Apple recommend only businesses with expertise and a previously integrated payment processing system use APIs instead of SDKs.
10.2.1 Transaction Types That Use Apple Pay
In the Moneris Gateway API, there are two transaction types that allow you to process decrypted transaction payload information with Apple Pay:
l
l
10.4 Cavv Purchase – Apple Pay 10.4 Cavv Purchase – Apple Pay
10.5 Cavv Pre-Authorization – Apple Pay
November 2018
Page 329 of 486
Moneris Gateway API - Integration Guide
NOTE: INTERAC® e-Commerce functionality is currently available using the Cavv
Purchase transaction type only.
Once you have processed the initial transaction using Cavv Purchase or Cavv Pre-Authorization, if
required you can then process any of the following transactions:
l
l
l
Refund (page 35)
Pre-Authorization Completion (page 25)
Purchase Correction (page 33)
10.3 Apple Pay In-App Process Flows
For both API and SDK methods of mobile in-app integration, the merchant’s iOS app uses Apple’s PassKit
Framework to request and receive encrypted payment details from Apple. When payment details are
returned in their encrypted form, they can be decrypted and processed by the Moneris Gateway in one
of two ways: SDK or API.
Steps in the Apple Pay In-App and on the Web payment process
API
1. Merchant’s mobile application or web page requests and receives the encrypted payload.
2. Encrypted payload is sent to the merchant’s server, where it is decrypted.
Page 330 of 486
November 2018
10 Apple Pay In-App and on the Web Integration
3. Moneris Gateway receives the decrypted payload from the merchant’s server, and processes the
Cavv Purchase – Apple Pay (page 331)Cavv Purchase – Apple Pay (page 331) or Cavv Pre-Authorization – Apple Pay (page 336)Cavv Pre-Authorization – Apple Pay (page 336) transaction.
a. Please ensure the wallet indicator is properly populated with the correct value (APP for
Apple Pay In-App or APW for Apple Pay on the Web).
SDK
1. Merchant's mobile application or web page requests and receives the encrypted payload.
2. Encrypted payload is sent from the merchant’s server to the Moneris Gateway, and the payload is
decrypted and processed.
This guide only deals with the API method; for detailed information about the SDK method of integration, see the Moneris Developer Portal at https://developer.moneris.com.
10.4 Cavv Purchase – Apple Pay
The Cavv Purchase for Apple Pay transaction follows a 3-D Secure model but it does not require an MPI.
Once the Apple Pay payload has been decrypted, this Purchase verifies funds on the customer’s card,
removes the funds and prepares them for deposit into the merchant’s account.
For Apple Pay processing, this transaction is only applicable if choosing to integrate directly to the Apple
Wallet (if not using the Moneris Apple Pay SDK). Please refer to 10 Apple Pay In-App and on the Web
Integration for more details on your integration options.
Refer to Apple's Developer Portal for details on integrating directly to Apple Wallet to retrieve the payload data.
CavvPurchase transaction object definition
CavvPurchase cavvPurchase = new CavvPurchase();
HttpsPostRequest object for Cavv Purchase transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(cavvPurchase);
Cavv Purchase transaction values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
November 2018
Page 331 of 486
Moneris Gateway API - Integration Guide
Table 95: Cavv Purchase transaction object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
cavvPurchase.SetOrderId
(order_id);
Amount
String
10-character decimal
cavvPurchase.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
Page 332 of 486
String
20-character alphanumeric
cavvPurchase.SetPan(pan);
November 2018
10 Apple Pay In-App and on the Web Integration
Table 95: Cavv Purchase transaction object mandatory values
Value
Expiry date
Type
String
Limits
4-character alphanumeric
Set method
cavvPurchase.SetExpdate
(expiry_date);
YYMM format
CAVV
String
100-character alphanumeric
cavvPurchase.SetCavv(cavv);
String
1-character alphanumeric
cavvPurchase.SetCryptType
(crypt);
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, CAVV field contains the decrypted
cryptogram. For more,
see Appendix A Definitions of Request
Fields.
E-commerce indicator
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, the E-commerce indicator is a
mandatory field containing the value
received from the
decrypted payload or a
default value of 5. If
you get a 2-character
value (e.g.,. 05 or 07)
from the payload,
remove the initial 0
and just send us the
2nd character. For
more, see Appendix A
Definitions of Request
Fields.
November 2018
Page 333 of 486
Moneris Gateway API - Integration Guide
Table 1 CavvPurchase transaction object optional values
Value
Type
Limits
Set Method
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Customer ID
String
50-character alphanumeric
cavvPurchase.SetCustId(cust_
id);
Dynamic descriptor
String
20-character alphanumeric
cavvPurchase
.SetDynamicDescriptor
(dynamic_descriptor);
Card Match ID
String
50-character alphanumeric
cavvPurchase.SetCmId
(transaction_id);
Customer information
Object
N/A
cavvPurchase.SetCustInfo
(customer);
Network
String
alphabetical
cavvPurchase.setNetwork
(network);
String
3-character alphanumeric
cavvPurchase.setDataType
(data_type);
NOTE: Applies to Offlinx™ only; must be
unique value for each
transaction
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Data Type
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Page 334 of 486
November 2018
10 Apple Pay In-App and on the Web Integration
Sample Cavv Purchase for Apple Pay
namespace Moneris
{
using System;
using System.Collections;
public class TestCanadaCavvPurchase
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "CUS887H67";
string amount = "10.42";
string pan = "4242424242424242";
string expdate = "1901"; //YYMM
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA=";
string dynamic_descriptor = "123456";
string wallet_indicator = "APP";
string processing_country_code = "CA";
string crypt_type = "5";
bool status_check = false;
CofInfo cof = new CofInfo();
cof.SetPaymentIndicator("U");
cof.SetPaymentInformation("2");
cof.SetIssuerId("168451306048014");
CavvPurchase cavvPurchase = new CavvPurchase();
cavvPurchase.SetOrderId(order_id);
cavvPurchase.SetCustId(cust_id);
cavvPurchase.SetAmount(amount);
cavvPurchase.SetPan(pan);
cavvPurchase.SetExpDate(expdate);
cavvPurchase.SetCavv(cavv);
cavvPurchase.SetCryptType(crypt_type); //Mandatory for AMEX cards only
cavvPurchase.SetDynamicDescriptor(dynamic_descriptor);
//cavvPurchase.SetNetwork("Interac"); //set only for Interac e-commerce
//cavvPurchase.SetDataType("3DSecure"); //set only for Interac e-commerce
//cavvPurchase.SetWalletIndicator(wallet_indicator); //set only wallet transactions e.g. APPLE PAY
//cavvPurchase.SetCmId("8nAK8712sGaAkls56"); //set only for usage with Offlinx - Unique max 50
alphanumeric characters transaction id generated by merchant
cavvPurchase.SetCofInfo(cof);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(cavvPurchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
November 2018
Page 335 of 486
Moneris Gateway API - Integration Guide
Sample Cavv Purchase for Apple Pay
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.WriteLine("IssuerId = " + receipt.GetIssuerId());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
10.5 Cavv Pre-Authorization – Apple Pay
The Cavv Pre-Authorization for Apple Pay transaction follows a 3-D Secure model but it does not require
an MPI. Once the Apple Pay payload has been decrypted, this Pre-Authorization verifies funds on the customer’s card, and holds the funds. To prepare the funds for deposit into the merchant’s account please
process a Pre-Authorization Completion transaction.
For Apple Pay processing, this transaction is only applicable if choosing to integrate directly to the Apple
Wallet (if not using the Moneris Apple Pay SDK). Please refer to 10 Apple Pay In-App and on the Web
Integration for more details on your integration options.
Refer to Apple's Developer Portal for details on integrating directly to Apple Wallet to retrieve the payload data.
NOTE: INTERAC® e-Commerce functionality is currently available using the Cavv
Purchase transaction type only.
Cavv Pre-Authorization transaction object definition
CavvPreAuth cavvPreauth = new CavvPreAuth();
HttpsPostRequest object for Cavv Pre-Authorization transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(cavvPreauth);
Page 336 of 486
November 2018
10 Apple Pay In-App and on the Web Integration
Cavv Pre-Authorization transaction values
Table 96: Cavv Pre-Authorization object mandatory values
Value
Type
Limits
Set method
Order ID
String
50-character alphanumeric
cavvPreauth.SetOrderId(order_
id);
Amount
String
10-character decimal
cavvPreauth.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
November 2018
String
20-character numeric
cavvPreauth.SetPan(pan);
Page 337 of 486
Moneris Gateway API - Integration Guide
Value
Type
Limits
Set method
Cardholder Authentication Verification Value
(CAVV)
String
50-character alphanumeric
cavvPreauth.SetCavv(cavv);
Expiry date
String
4-character numeric
cavvPreauth.SetExpdate
(expiry_date);
E-commerce indicator
String
1-character alphanumeric
cavvPreauth.SetCryptType
(crypt);
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, CAVV field contains the decrypted
cryptogram. For more,
see Appendix A Definitions of Request
Fields.
NOTE: For Apple Pay
Cavv Purchase and Cavv
Pre-Authorization transactions, the E-commerce indicator is a
mandatory field containing the value
received from the
decrypted payload or a
default value of 5. If
you get a 2-character
value (e.g.,. 05 or 07)
from the payload,
remove the initial 0
and just send us the
2nd character. For
more, see Appendix A
Definitions of Request
Fields.
Table 1 Cavv Pre-Authorization object optional values
Value
Type
Limits
Set method
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Customer ID
String
50-character alphanumeric
cavvPreauth.SetCustId(cust_
id);
Dynamic descriptor
String
20-character alpha-
cavvPreauth
Page 338 of 486
November 2018
10 Apple Pay In-App and on the Web Integration
Value
Card Match ID
Type
Limits
Set method
numeric
.SetDynamicDescriptor
(dynamic_descriptor);
String
50-character alphanumeric
cavvPreauth.SetCmId
(transaction_id);
String
alphabetical
cavvPurchase.setNetwork
(network);
String
3-character alphanumeric
cavvPurchase.setDataType
(data_type);
NOTE: Applies to Offlinx™ only; must be
unique value for each
transaction
Network
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Data Type
NOTE: This request variable is mandatory for
INTERAC® e-Commerce
transactions conducted
via Apple Pay, and is
not for use with credit
card transactions.
Sample Cavv Pre-Authorization for Apple Pay
namespace Moneris
{
using System;
using System.Collections;
public class TestCanadaCavvPreauth
{
public static void Main(string[] args)
{
string store_id = "store5";
string api_token = "yesguy";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "CUS887H67";
string amount = "10.42";
string pan = "4242424242424242";
November 2018
Page 339 of 486
Moneris Gateway API - Integration Guide
Sample Cavv Pre-Authorization for Apple Pay
string expdate = "1911"; //YYMM format
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA=";
string dynamic_descriptor = "123456";
string wallet_indicator = "APP";
string processing_country_code = "CA";
string crypt_type = "5";
bool status_check = false;
CofInfo cof = new CofInfo();
cof.SetPaymentIndicator("U");
cof.SetPaymentInformation("2");
cof.SetIssuerId("168451306048014");
CavvPreAuth cavvPreauth = new CavvPreAuth();
cavvPreauth.SetOrderId(order_id);
cavvPreauth.SetCustId(cust_id);
cavvPreauth.SetAmount(amount);
cavvPreauth.SetPan(pan);
cavvPreauth.SetExpDate(expdate);
cavvPreauth.SetCavv(cavv);
cavvPreauth.SetCryptType(crypt_type); //Mandatory for AMEX cards only
cavvPreauth.SetDynamicDescriptor(dynamic_descriptor);
//cavvPreauth.SetWalletIndicator(wallet_indicator); //set only wallet transactions e.g. APPLE PAY
//cavvPreauth.SetCmId("8nAK8712sGaAkls56"); //set only for usage with Offlinx - Unique max 50
alphanumeric characters transaction id generated by merchant
cavvPreauth.SetCofInfo(cof);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(cavvPreauth);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.WriteLine("IssuerId = " + receipt.GetIssuerId());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
Page 340 of 486
November 2018
10 Apple Pay In-App and on the Web Integration
Sample Cavv Pre-Authorization for Apple Pay
}
}
}
}
November 2018
Page 341 of 486
Moneris Gateway API - Integration Guide
11 Offlinx™
l
l
What Is a Pixel Tag?
Offlinx™ and API Transactions
11.1 What Is a Pixel Tag?
A pixel tag is a piece of code that goes on a web page and requests an image file (a tiny transparent image
or pixel) when loaded, which, while not visible to the user, allows Offlinx™ to gather relevant information
about the user.
The data collected by our pixel tag is:
l
l
l
Anonymous (not personally identifiable) and compliant with privacy standards
Secure — utilizes SSL communication to transmit the data securely
Not shared with anyone
11.2 Offlinx™ and API Transactions
The Offlinx™ Card Match pixel tag feature can be implemented via the Unified API with the Card Match
ID variable, which corresponds to the Transaction ID in Offlinx™. The Card Match ID must be a unique
value for each transaction.
For more information about the Offlinx™ solution, consult the Offlinx™ Pixel Tag Setup Guide available
from your account/service manager.
API transactions where this applies:
l
l
l
l
l
l
Purchase
Pre-Authorization
Purchase with 3-D Secure – cavvPurchase
Pre-Authorization with 3-D Secure – cavvPreauth
Cavv Purchase – Apple Pay
Cavv Pre-Authorization – Apple Pay
Page 342 of 486
November 2018
12 Convenience Fee
l
l
l
l
12.1
12.2
12.3
12.4
About Convenience Fee
Purchase with Convenience Fee
Convenience Fee Purchase w/ Customer Information
Convenience Fee Purchase with VbV, MCSC and Amex SafeKey
12.1 About Convenience Fee
The Convenience Fee program was designed to allow merchants to offer the convenience of an alternative payment channel to the cardholder at a charge. This applies only when providing a true "convenience" in the form of an alternative payment channel outside the merchant's customary face-to-face
payment channels. The convenience fee will be a separate charge on top of what the consumer is paying
for the goods and/or services they were given, and this charge will appear as a separate line item on the
consumer’s statement.
NOTE: The Convenience Fee program is only offered to certain supported Merchant Category Codes (MCCs). Please speak to your account manager for further details.
12.2 Purchase with Convenience Fee
NOTE: Convenience Fee Purchase with Customer Information is also supported.
Convenience Fee Purchase transaction object definition
Purchase purchase = new Purchase();
HttpsPostRequest object for Convenience Fee Purchase transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(purchase);
Convenience Fee Purchase transaction object values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
November 2018
Page 343 of 486
Moneris Gateway API - Integration Guide
Table 1 Convenience Fee Purchase transaction object mandatory values
Value
Type
Limits
Set Method
Convenience Fee
Object
n/a
purchase.SetConvFeeInfo
(convFeeInfo);
Order ID
String
50-character alphanumeric
purchase.SetOrderId(order_
id);
Amount
String
10-character decimal
purchase.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
String
20-character numeric
purchase.SetPan(pan);
Expiry date
String
4-character numeric
YYMM format
purchase.SetExpdate(expiry_
date);
E-commerce indicator
String
1-character alphanumeric
purchase.SetCryptType(crypt);
Convenience fee
amount
String
9-character decimal
.SetConvFeeInfo(convfee_
amount);
Table 2 Convenience Fee Purchase transaction object optional values
Value
Type
Limits
Set Method
Customer ID
String
50-character alphanumeric
purchase.SetCustId(cust_id);
Dynamic descriptor
String
20-character alphanumeric
purchase.SetDynamicDescriptor
(dynamic_descriptor);
AVS information
Object
purchase.SetAvsInfo
(avsCheck);
CVD information
Object
purchase.SetCvdInfo
(cvdCheck);
Page 344 of 486
November 2018
12 Convenience Fee
Sample Purchase with Convenience Fee
namespace Moneris
{
using System;
public class TestCanadaConvFeePurchase
{
public static void Main(string[] args)
{
string store_id = "monca00392";
string api_token = "qYdISUhHiOdfTr1CLNpN";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string amount = "5.00";
string pan = "4242424242424242";
string expdate = "1602"; //YYMM format
string crypt = "7";
string convenience_fee = "1.00";
string processing_country_code = "CA";
bool status_check = false;
ConvFeeInfo convFeeInfo = new ConvFeeInfo();
convFeeInfo.SetConvenienceFee(convenience_fee);
Purchase purchase = new Purchase();
purchase.SetOrderId(order_id);
purchase.SetAmount(amount);
purchase.SetPan(pan);
purchase.SetExpDate(expdate);
purchase.SetCryptType(crypt);
purchase.SetConvFeeInfo(convFeeInfo);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(purchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CfSuccess = " + receipt.GetCfSuccess());
Console.WriteLine("CfStatus = " + receipt.GetCfStatus());
Console.WriteLine("FeeAmount = " + receipt.GetFeeAmount());
Console.WriteLine("FeeRate = " + receipt.GetFeeRate());
Console.WriteLine("FeeType = " + receipt.GetFeeType());
//Console.WriteLine("CardLevelResult = " + receipt.GetCardLevelResult());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
November 2018
Page 345 of 486
Moneris Gateway API - Integration Guide
Sample Purchase with Convenience Fee
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
12.3 Convenience Fee Purchase w/ Customer Information
Convenience Fee Purchase with Customer information transaction object definition
Purchase purchase = new Purchase();
HttpsPostRequest object for Convenience Fee Purchase with Customer Info transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(purchase);
Convenience Fee Purchase with Customer information transaction object values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
Table 1 Convenience Fee Purchase w/ Customer Info transaction object mandatory values
Value
Type
Limits
Set Method
Convenience Fee
Object
n/a
purchase.SetConvFeeInfo
(convFeeInfo);
Order ID
String
50-character alphanumeric
purchase.SetOrderId(order_
id);
Amount
String
10-character decimal
purchase.SetAmount(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
Page 346 of 486
String
20-character numeric
purchase.SetPan(pan);
November 2018
12 Convenience Fee
Table 1 Convenience Fee Purchase w/ Customer Info transaction object mandatory values (continued)
Value
Type
Limits
Set Method
Expiry date
String
4-character numeric
YYMM format
purchase.SetExpdate(expiry_
date);
E-commerce indicator
String
1-character alphanumeric
purchase.SetCryptType(crypt);
Convenience fee
amount
String
9-character decimal
purchase.SetConvFeeInfo
(convfee_amount);
Table 2 Convenience Fee Purchase w/ Customer Info transaction object optional values
Value
Type
Limits
Set Method
Customer ID
String
50-character alphanumeric
purchase.SetCustId(cust_id);
Dynamic descriptor
String
20-character alphanumeric
purchase.SetDynamicDescriptor
(dynamic_descriptor);
Customer information
Object
n/a
purchase.SetCustInfo
(customer);
AVS information
Object
n/a
purchase.SetAvsInfo
(avsCheck);
CVD information
Object
n/a
purchase.SetCvdInfo
(cvdCheck);
Sample Convenience Fee Purchase with Customer Information
namespace Moneris
{
using System;
public class TestCanadaConvFeePurchaseCustInfo
{
public static void Main(string[] args)
{
string store_id = "monca00392";
string api_token = "qYdISUhHiOdfTr1CLNpN";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string amount = "5.00";
string pan = "4005554444444403";
string expdate = "1602"; //YYMM format
November 2018
Page 347 of 486
Moneris Gateway API - Integration Guide
Sample Convenience Fee Purchase with Customer Information
string crypt = "7";
string cust_id = "my customer id";
string convenience_fee = "1.00";
string processing_country_code = "CA";
bool status_check = false;
ConvFeeInfo convFeeInfo = new ConvFeeInfo();
convFeeInfo.SetConvenienceFee(convenience_fee);
Purchase purchase = new Purchase();
purchase.SetOrderId(order_id);
purchase.SetCustId(cust_id);
purchase.SetAmount(amount);
purchase.SetPan(pan);
purchase.SetExpDate(expdate);
purchase.SetCryptType(crypt);
purchase.SetConvFeeInfo(convFeeInfo);
/********************* Billing/Shipping Variables ****************************/
string first_name = "Bob";
string last_name = "Smith";
string company_name = "ProLine Inc.";
string address = "623 Bears Ave";
string city = "Chicago";
string province = "Illinois";
string postal_code = "M1M2M1";
string country = "Canada";
string phone = "777-999-7777";
string fax = "777-999-7778";
string tax1 = "10.00";
string tax2 = "5.78";
string tax3 = "4.56";
string shipping_cost = "10.00";
/********************* Order Line Item Variables *****************************/
string[] item_description = new string[] { "Chicago Bears Helmet", "Soldier Field Poster" };
string[] item_quantity = new string[] { "1", "1" };
string[] item_product_code = new string[] { "CB3450", "SF998S" };
string[] item_extended_amount = new string[] { "150.00", "19.79" };
/********************** Customer Information Object **************************/
CustInfo customer = new CustInfo();
/********************** Set Customer Billing Information **********************/
customer.SetBilling(first_name, last_name, company_name, address, city,
province, postal_code, country, phone, fax, tax1, tax2,
tax3, shipping_cost);
/******************** Set Customer Shipping Information ***********************/
customer.SetShipping(first_name, last_name, company_name, address, city,
province, postal_code, country, phone, fax, tax1, tax2,
tax3, shipping_cost);
/***************************** Order Line Items ******************************/
customer.SetItem(item_description[0], item_quantity[0],
item_product_code[0], item_extended_amount[0]);
customer.SetItem(item_description[1], item_quantity[1],
item_product_code[1], item_extended_amount[1]);
purchase.SetCustInfo(customer);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(purchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
Page 348 of 486
November 2018
12 Convenience Fee
Sample Convenience Fee Purchase with Customer Information
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("CfSuccess = " + receipt.GetCfSuccess());
Console.WriteLine("CfStatus = " + receipt.GetCfStatus());
Console.WriteLine("FeeAmount = " + receipt.GetFeeAmount());
Console.WriteLine("FeeRate = " + receipt.GetFeeRate());
Console.WriteLine("FeeType = " + receipt.GetFeeType());
//Console.WriteLine("CardLevelResult = " + receipt.GetCardLevelResult());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
12.4 Convenience Fee Purchase with VbV, MCSC and Amex SafeKey
Convenience Fee Purchase with VbV/MCSC/SafeKey transaction object definition
CavvPurchase cavvPurchase = new CavvPurchase();
HttpsPostRequest object for Convenience Fee Purchase w/ VbV/MCSC/SafeKey transaction
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetTransaction(cavvPurchase);
Convenience Fee Purchase with VbV/MCSC/SafeKey transaction object values
For a full description of mandatory and optional values, see Appendix A Definitions of Request Fields
November 2018
Page 349 of 486
Moneris Gateway API - Integration Guide
Table 1 Convenience Fee Purchase with VbV, MCSC, SafeKey - Required Fields
Value
Type
Limits
Set Method
Convenience Fee
Object
N/A
cavvPurchase.SetConvFeeInfo
(convFeeInfo);
Order ID
String
50-character alphanumeric
cavvPurchase.SetOrderId
(order_id);
Amount
String
10-character decimal
cavvPurchase.SetAmount
(amount);
Up to 7 digits
(dollars) + decimal
point (.) + 2 digits
(cents) after the
decimal point
EXAMPLE: 1234567.89
Credit card number
String
20-character numeric
cavvPurchase.SetPan(pan);
Expiry date
String
4-character numeric
YYMM format
cavvPurchase.SetExpdate
(expiry_date);
E-Commerce indicator
String
1-character alphanumeric
cavvPurchase.SetCryptType
(crypt);
Cardholder Authentication Verification Value
(CAVV)
String
50-character alphanumeric
cavvPurchase.SetCavv(cavv);
Convenience fee
amount
String
9-character decimal
.SetConvFeeInfo(convfee_
amount);
Table 2 Convenience Fee Purchase with VbV, MCSC, SafeKey - Optional Values
Value
Type
Limits
Set Method
Status Check
Boolean
true/false
mpgReq.SetStatusCheck(status_
check);
Customer ID
String
50-character alphanumeric
cavvPurchase.SetCustId(cust_
id);
Dynamic descriptor
String
20-character alphanumeric
cavvPurchase
.SetDynamicDescriptor
(dynamic_descriptor);
Page 350 of 486
November 2018
12 Convenience Fee
Value
Type
Limits
Set Method
E-commerce indicator
String
1-character numeric
cavvPurchase.SetCryptType
(crypt);
Customer Information
Object
N/A
cavvPurchase.SetCustInfo
(customer);
AVS Information
Object
N/A
cavvPurchase.SetAvsInfo
(avsCheck);
CVD Information
Object
N/A
cavvPurchase.SetCvdInfo
(cvdCheck);
Sample Purchase with VbV/MCSC/SafeKey
namespace Moneris
{
using System;
using System.Collections;
public class TestCanadaConvFeeCavvPurchase
{
public static void Main(string[] args)
{
string store_id = "monca00392";
string api_token = "qYdISUhHiOdfTr1CLNpN";
string order_id = "Test" + DateTime.Now.ToString("yyyyMMddhhmmss");
string cust_id = "B_Urlac_54";
string amount = "10.42";
string pan = "4005554444444403";
string expdate = "1901"; //YYMM format
string cavv = "AAABBJg0VhI0VniQEjRWAAAAAAA";
string crypt_type = "5";
string convenience_fee = "1.00";
string dynamic_descriptor = "my descriptor";
string processing_country_code = "CA";
bool status_check = false;
AvsInfo avsCheck = new AvsInfo();
avsCheck.SetAvsStreetNumber("212");
avsCheck.SetAvsStreetName("Payton Street");
avsCheck.SetAvsZipCode("M1M1M1");
CvdInfo cvdCheck = new CvdInfo();
cvdCheck.SetCvdIndicator("1");
cvdCheck.SetCvdValue("099");
ConvFeeInfo convFeeInfo = new ConvFeeInfo();
convFeeInfo.SetConvenienceFee(convenience_fee);
CavvPurchase cavvPurchase = new CavvPurchase();
cavvPurchase.SetOrderId(order_id);
cavvPurchase.SetCustId(cust_id);
cavvPurchase.SetAmount(amount);
cavvPurchase.SetPan(pan);
cavvPurchase.SetExpDate(expdate);
cavvPurchase.SetCavv(cavv);
cavvPurchase.SetCryptType(crypt_type); //Mandatory for AMEX cards only
November 2018
Page 351 of 486
Moneris Gateway API - Integration Guide
Sample Purchase with VbV/MCSC/SafeKey
cavvPurchase.SetDynamicDescriptor(dynamic_descriptor);
cavvPurchase.SetAvsInfo(avsCheck);
cavvPurchase.SetCvdInfo(cvdCheck);
cavvPurchase.SetConvFeeInfo(convFeeInfo);
HttpsPostRequest mpgReq = new HttpsPostRequest();
mpgReq.SetProcCountryCode(processing_country_code);
mpgReq.SetTestMode(true); //false or comment out this line for production transactions
mpgReq.SetStoreId(store_id);
mpgReq.SetApiToken(api_token);
mpgReq.SetTransaction(cavvPurchase);
mpgReq.SetStatusCheck(status_check);
mpgReq.Send();
try
{
Receipt receipt = mpgReq.GetReceipt();
Console.WriteLine("CardType = " + receipt.GetCardType());
Console.WriteLine("TransAmount = " + receipt.GetTransAmount());
Console.WriteLine("TxnNumber = " + receipt.GetTxnNumber());
Console.WriteLine("ReceiptId = " + receipt.GetReceiptId());
Console.WriteLine("TransType = " + receipt.GetTransType());
Console.WriteLine("ReferenceNum = " + receipt.GetReferenceNum());
Console.WriteLine("ResponseCode = " + receipt.GetResponseCode());
Console.WriteLine("ISO = " + receipt.GetISO());
Console.WriteLine("BankTotals = " + receipt.GetBankTotals());
Console.WriteLine("Message = " + receipt.GetMessage());
Console.WriteLine("AuthCode = " + receipt.GetAuthCode());
Console.WriteLine("Complete = " + receipt.GetComplete());
Console.WriteLine("TransDate = " + receipt.GetTransDate());
Console.WriteLine("TransTime = " + receipt.GetTransTime());
Console.WriteLine("Ticket = " + receipt.GetTicket());
Console.WriteLine("TimedOut = " + receipt.GetTimedOut());
Console.WriteLine("Avs Response = " + receipt.GetAvsResultCode());
Console.WriteLine("Cvd Response = " + receipt.GetCvdResultCode());
//Console.WriteLine("CardLevelResult = " + receipt.GetCardLevelResult());
Console.WriteLine("CavvResultCode = " + receipt.GetCavvResultCode());
Console.WriteLine("CfSuccess = " + receipt.GetCfSuccess());
Console.WriteLine("CfStatus = " + receipt.GetCfStatus());
Console.WriteLine("FeeAmount = " + receipt.GetFeeAmount());
Console.WriteLine("FeeRate = " + receipt.GetFeeRate());
Console.WriteLine("FeeType = " + receipt.GetFeeType());
//Console.WriteLine("StatusCode = " + receipt.GetStatusCode());
//Console.WriteLine("StatusMessage = " + receipt.GetStatusMessage());
Console.ReadLine();
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
}
}
Page 352 of 486
November 2018
13 Recurring Billing
l
l
l
l
l
1 About Recurring Billing
13.2 Purchase with Recurring Billing
13.3 Recurring Billing Update
1 Recurring Billing Response Fields and Codes
13.5 Credential on File and Recurring Billing
13.1 About Recurring Billing
Recurring Billing allows you to set up payments whereby Moneris automatically processes the transactions and bills customers on your behalf based on the billing cycle information you provide.
Recurring Billing series are created by sending the Recurring Billing object in these transactions:
l
l
l
Purchase
Purchase with Vault
Purchase with 3-D Secure (cavvPurchase)
You can modify a Recurring Billing series after it has been created by sending the Recurring Billing Update
administrative transaction.
NOTE: Alternatively, if you prefer to manage recurring series on your own merchant system, you can send the periodic payments as basic Purchase transactions with the e-commerce indicator (crypt_type) value = 2 and with the Credential on File info object
included.
13.2 Purchase with Recurring Billing
Recurring Billing Info Object Definition
Recur recurring_cycle = new Recur(recur_unit, start_now, start_date, num_
recurs, period, recur_amount);
Transaction object set method