3.1. ASPECTOS GENERALES DE LA TECNOLOGÍA
3.1.4. Funcionamiento del arreglo de jeteo
In order to process Visa and MasterCard Level III transactions and/or American Express Level II; you must be certified for basic processing on the MeS Payment Gateway. It is important to submit all fields in the core Payment Gateway specifications for Commercial Card (table 7.4) for Visa, MasterCard, and American Express.
These additional fields are only supported by Immediate Sale (D) and Settle (S)
transaction types. Attempting to send this additional data with other transaction types will result in an error (EC 136). In the case of submission of a pre-authorization followed by a settle, these additional fields should only be included in the Settle (S) message.
14.2 Request Fields for Visa and MasterCard Level III
Field Name Description Length Format Comments
line_item_count Number of line item records
included in the request. 3 N Total number of line item detail records for the transaction. Required by VI and MC merchant_tax_id Merchant VAT Tax Number. 20 AN Required by VI customer_tax_id Customer VAT Registration Number 13 AN Required by VI summary_commodity_code Summary Commodity Code 4 Required by VI
discount_amount Discount Amount 12 N nnnnnnnnnn.nn
Required by VI
shipping_amount Freight Amount 12 N nnnnnnnnnn.nn
Required by VI and MC
duty_amount Duty Amount 12 N nnnnnnnnnn.nn
Required by VI and MC ship_to_zip Destination Postal/Zip Code 10 AN Required by VI and MC ship_from_zip Ship from Postal/Zip Code 10 AN Required by VI and MC dest_country_code Destination Country Code 3 N http://en.wikipedia.org/wiki/ISO_
3166-1_numeric. Required by VI and MC vat_invoice_number Invoice Reference Number 15 AN Required by VI
order_date Order Date 6 N YYMMDD
Required by VI vat_amount Value Added Tax Amount 12 N nnnnnnnnnn.nn Required by VI alt_tax_amount MasterCard Alternate Tax Amount 12 N nnnnnnnnnn.nn Required by MC
alt_tax_amount_indicator MasterCard Alternate Tax Indicator 1 Y or N If Y indicate tax amount, if N fill tax amount with all zeros Required by MC visa_line_item Visa Line Item Detail Data See Visa
table below
See Visa table below
Note that subfields are separated by <|>
For multiple line items, send the field name followed by the detail for each item.
mc_line_item MasterCard Line Item Detail Data See MC table below
See MC table below
Note that subfields are separated by <|>
For multiple line items, send the field name followed by the detail for each item.
14.3 Visa Line Item Subfields
Subfields are separated by <|> Example: 5096<|>carbon dioxideequipment<|>sales<|>1<|>each<|>33439.93<|>2340.79<|>7.0<|>0.00<|>33439.93<|>D Field Description Notes
Item Commodity Code Maximum 12 characters
Item Descriptor Maximum 35 characters
Product Code Maximum 12 characters
Quantity Maximum 12 digits
Unit Of Measure Maximum 12 characters
Unit Cost Maximum 12 digits. Example: 1.35
Vat Tax Amount Maximum 12 digits
Vat Tax Rate Maximum 4 digits. 7.5 = 7.5%
Discount Per Line Item Maximum 12 digits
Line Item Total Maximum 12 digits
Debit Or Credit Indicator D or C
14.4 MasterCard Line Item Subfields
Subfields are separated by <|> Example:Signage<|>Pylon<|>1<|>ea<|>000000000000000<|>5.0<|>stat<|>1400.00<|>N<|>N<|>31064.00<|>D<|>0. 00
Field Description Notes
Item Description Maximum 35 characters
Product Code Maximum 12 characters
Item Quantity Maximum 12 digits
Item Unit Of Measure Maximum 12 characters
Alternate Tax Identifier Maximum 15 characters
Tax Rate Applied Maximum 4 digits. 5.25 = 5.25%
Tax Type Applied Maximum 4 characters
Tax Amount Maximum 12 digits
Discount Indicator Y or N
Field Description Notes
Extended Item Amount Maximum 9 digits
Debit Or Credit Indicator D or C
Discount Amount Maximum 12 digits
14.5 Request Fields American Express
Field Name Description Length Format Comments
requester_name
Name of the requester; i.e., the person who ordered or purchase the
product or service 38
A/N, Upper
Case
Optional field, however this data must be sent if provided by the merchant’s customer. cardholder_reference_num
ber Reference number used by the cardholder to identify the
transaction 17 A/N
ship_to_zip Destination Postal/Zip Code 10 AN
vat_amount Value Added Tax Amount 12 N nnnnnnnnnn.nn line_item_count Sequential number beginning with 1
for each line item. 3 N
amex_line_item Submit this name value followed by subfields
14.6 American Express Line Item Subfields
Subfields are separated by <|> Example: &line_item_count=4&amex_line_item=SKILL
SAW<|>4<|>205.50&amex_line_item=NAILS<|>2<|>410.50&amex_line_item=CEDAR LUMBER<|>5<|>399.99& amex_line_item=BRICKS<|>10<|>675.45
Description Length Format Comments
Concise description of the item(s) purchased. Generic descriptions like “MERCHANDISE” should be avoided. 40 A/N, Upper Case Depending on a submitter’s processing method this field may be required. Moreover, if a merchant’s customer provides Charge Description Data, these fields are required.
This field contains the quantities that correspond to the item(s)
described in the preceding field. 3 numeric
This field is required if data is submitted in the corresponding charge description field This field contains the unit cost that
corresponds to the item(s)
described in the preceding field. 12 numeric
This field is required if data is submitted in the corresponding charge description field
14.7 Level III Error Codes
Error Code
Error Description Required Action
127 Invalid Level III Line Item Detail. Correct the data in the line item detail record and resubmit.
128 Invalid Level III Merchant Tax ID. Provide a valid Merchant Tax ID. 129 Invalid Level III Customer Tax ID. Provide a valid Customer Tax ID.
Error Code
Error Description Required Action
131 Invalid Level III Ship To Zip. Provide a valid destination postal code. 132 Invalid Level III Ship From Zip. Provide a valid source postal code. 133 Invalid Level III Destination Country Code. Provide a valid Destination Country Code. 134 Invalid Level III VAT Invoice Number. Provide a valid VAT Invoice Number. 135 Invalid Level III Alternate Tax Indicator. Provide a valid Alternate Tax Indicator. 136 Transaction type does not support Level III
data.
Remove the level III data OR use a valid transaction type.
137 Invalid Level III Discount Amount. Provide a valid Discount Amount. 138 Invalid Level III Duty Amount. Provide a valid Duty Amount. 139 Invalid Level III Order Date. Provide a valid Order Date. 140 Invalid Level III VAT Amount. Provide a valid VAT Amount. 141 Invalid Level III VAT Rate. Provide a valid VAT Rate.
142 Invalid Level III Alternate Tax Amount. Provide a valid Alternate Tax Amount. 143 Invalid Level III Line Item Count. Provide a valid Line Item Count.
144 Invalid Level III Card Type. Provide valid line item detail data for the card type.
14.8 Sale (D) – Source Code Example
Request Params (line item detail is URL encoded): POST /mes-api/tridentApi HTTP/1.1 Content-Type: application/x-www-form-urlencoded Cache-Control: no-cache Pragma: no-cache User-Agent: Java/1.7.0_21 Host: api.merchante-solutions.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Connection: keep-alive Content-Length: 578 profile_id=94100008043900000004&profile_key=gvQzgKXOTEoDzpzJzROrQQzoKLaEqxjf&tran saction_type=D&cardholder_street_address=123&cardholder_zip=55555&cvv2=123&transaction _amount=1.00&card_number=4012888812348882&card_exp_date=1111&invoice_number=209e 3212d67d2b49d&ship_to_zip=99216&ship_from_zip=99212&line_item_count=1&merchant_tax_i d=123&customer_tax_id=123&summary_commodity_code=123&discount_amount=1.00&shippin g_amount=1.00&duty_amount=1.00&dest_country_code=840&vat_invoice_number=123&order_ date=090908&vat_amount=1.00&alt_tax_amount=1.00&alt_tax_amount_indicator=Y&visa_line_it em=5096%3C%7C%3EStuff%3C%7C%3Esales%3C%7C%3E1%3C%7C%3Eeach%3C%7C%3 E123.123%3C%7C%3E1.95%3C%7C%3E7.0%3C%7C%3E0.00%3C%7C%3E66.66%3C%7C% 3ED Response:
transaction_id=8fc94e10b12130f4ab8a8ceeac40fc69&error_code=000&auth_response_text=Ex act Match&avs_result=Y&cvv2_result=M&auth_code=T2067H
14.9 Settle (S) – Source Code Example
Request Params (line item detail is URL encoded): POST /mes-api/tridentApi HTTP/1.1 Content-Type: application/x-www-form-urlencoded Cache-Control: no-cache Pragma: no-cache User-Agent: Java/1.7.0_21 Host: api.merchante-solutions.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Connection: keep-alive Content-Length: 578 profile_id=94100008043900000004&profile_key=gvQzgKXOTEoDzpzJzROrQQzoKLaEqxjf&tran saction_type=S&transaction_amount=1.00&transaction_id=0dd82a4f676730c1b789c1f43279dc4 0&invoice_number=e19b17e690b5c053f&ship_from_zip=99212&line_item_count=1&merchant_t ax_id=123&customer_tax_id=123&summary_commodity_code=123&discount_amount=1.00&shi pping_amount=1.00&duty_amount=1.00&dest_country_code=840&vat_invoice_number=123&ord er_date=090908&vat_amount=1.00&alt_tax_amount=1.00&alt_tax_amount_indicator=Y&visa_lin e_item=5096%3C%7C%3EStuff%3C%7C%3Esales%3C%7C%3E1%3C%7C%3Eeach%3C%7C %3E123.123%3C%7C%3E1.95%3C%7C%3E7.0%3C%7C%3E0.00%3C%7C%3E66.66%3C%7 C%3ED Response: transaction_id=12f3befbd035371b9b82d5920465e071&error_code=000&auth_response_text=S ettle Request Accepted