Contents

MCC 6012

In order to reduce fraud, Visa and Mastercard have mandated that all merchants with a Merchant Category Code (MCC) of 6012 are required to send additional fields in AUTH and ACCOUNTCHECK requests, if provided by the customer making the payment.

Info
Your Merchant Category Code (MCC) is a four-digit number assigned to you by your acquirer. It is used to classify the business by the type of products or services it provides. If you are unsure of the value of your merchant category code, please contact our Support Team.

Warning
For merchants with MCC 6012, failure to submit these fields will result in a 60025 errorcode being returned in the response.

Inheritance

Once you have processed an AUTH or ACCOUNTCHECK containing these required fields, they can be inherited in future requests, and passed onto the acquiring bank automatically, if required.

 

 

Field specification

The required fields are as follows:

Key

Field name Type Length Request Response Description
customeraccountnumber Numeric  20 * If account number type is “ACCOUNT”, the account holder’s account number.If account number type is “CARD”, the account holder’s card number.

The returned value in the response is in a masked format, e.g. “411111#######1111”.

customeraccountnumbertype Alpha  7 Either “CARD” or “ACCOUNT”.
customerdob Date YYYY-MM-DD  10 The account holder’s date of birth.
customerpostcode Alphanumeric 25 The customer’s postcode or ZIP code.

If the country provided is not United States, Great Britain or Canada, or if no country is provided, the postcode field is not validated.

customerlastname Alphanumeric including
symbols
127 The customer’s last name.

 

Request example

The following AUTH request example includes the fields mandated by Visa and Mastercard for merchants with category code 6012:


#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "[email protected]"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
  "sitereference": "test_site12345",
  "requesttypedescriptions": ["AUTH"],
  "accounttypedescription": "ECOM",
  "currencyiso3a": "GBP",
  "baseamount": "1050",
  "orderreference": "My_Order_123",
  "cachetoken": "token_posted_by_st.js",
  "customeraccountnumber": "4111111111111111",
  "customeraccountnumbertype": "CARD",
  "customerdob": "1990-01-01",
  "customerpostcode": "TE456ST",
  "customerlastname": "Bloggs"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php

if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
  throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);

$configData = array(
  'username' => '[email protected]',
  'password' => 'Password1^',
);

$requestData = array(
  'sitereference' => 'test_site12345', 
  'requesttypedescriptions' => array('AUTH'),
  'accounttypedescription' => 'ECOM',
  'currencyiso3a' => 'GBP',
  'baseamount' => '1050',
  'orderreference' => 'My_Order_123',
  'cachetoken' => 'token_posted_by_st.js',
  'customeraccountnumber' => '4111111111111111',
  'customeraccountnumbertype' => 'CARD',
  'customerdob' => '1990-01-01',
  'customerpostcode' => 'TE456ST',
  'customerlastname' => 'Bloggs'
);

$api = Securetradingapi($configData);
$response = $api->process($requestData);
var_dump($response->toArray());

?>
curl --user [email protected]:Password1^ https://webservices.securetrading.net/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"[email protected]",
"version": "1.00",
"request": [{
  "currencyiso3a": "GBP",
  "requesttypedescriptions": ["AUTH"],
  "sitereference": "test_site12345",
  "baseamount": "1050",
  "orderreference": "My_Order_123",
  "accounttypedescription": "ECOM",
  "cachetoken": "token_posted_by_st.js",
  "customeraccountnumber": "4111111111111111",
  "customeraccountnumbertype": "CARD",
  "customerdob": "1990-01-01",
  "customerpostcode": "TE456ST",
  "customerlastname": "Bloggs"
}]}'