Effective date:
June 1, 2023
Processor:
Regions:
All
Services:
Authorization request and response
Feature
Merchants who support Mastercard must process new standardized card-acceptor-related information using new API fields. This prepares merchants for future payment enhancements with key transaction elements.
Acquirers

Acceptor Street Address

Street address for your business location.
Acquirers that support the acceptor street address must support the following data in the TC 33 capture file:
  • Record: CP12 TCR2
  • Position: 35–82
  • Field: Acceptor Street Address
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.merchantDescriptor.address1
  • SCMP API:
    merchant_descriptor_street
  • Simple Order API:
    invoiceHeader_merchantDescriptorStreet

Acceptor URL Address

URL or reverse domain name for your business.
Acquirers that support the acceptor URL address must support the following data in the TC 33 capture file:
  • Record: CP12 TCR3
  • Position: 5–168
  • Field: Acceptor URL Address
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.merchantDomainName
  • SCMP API:
    merchant_domain_name
  • Simple Order API:
    merchantDomainName

Acceptor Customer Service Phone Number

Customer service phone number for merchant.
Acquirers that support the acceptor customer service phone number must support the following data in the TC 33 capture file:
  • Record: CP12 TCR2
  • Position: 92–107
  • Field: Acceptor Customer Service Phone Number
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.merchantDescriptor.customerServicePhoneNumber
  • SCMP API:
    merchant_descriptor_customer_service_phone_number
  • Simple Order API:
    invoiceHeader_merchantDescriptorCustomerServicePhoneNumber

Acceptor Phone Number

Contact information for your business.
Acquirers that support the acceptor phone number must support the following data in the TC 33 capture file:
  • Record: CP12 TCR4
  • Position: 5–20
  • Field: Acceptor Phone Number
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API Field:
    merchantInformation.merchantDescriptor.contact
  • SCMP API Field:
    merchant_descriptor_contact
  • Simple Order API Field:
    invoiceHeader_merchantDescriptorContact

Acceptor Tax ID

Merchant tax ID number.
Acquirers that support the acceptor tax ID must support the following data in the TC 33 capture file:
  • Record: CP12 TCR4
  • Position: 21–55
  • Field: Acceptor Tax ID
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.taxId
  • SCMP API:
    bill_merchant_tax_id
  • Simple Order API:
    billTo_merchantTaxID

Acceptor Partner ID Code

Partner ID used for either co-branding agreement or promotional discounts.
Acquirers that support the acceptor partner ID code must support the following data in the TC 33 capture file:
  • Record: CP12 TCR4
  • Position: 56–63
  • Field: Acceptor Partner ID Code
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.partnerId
  • SCMP API:
    merchant_partneridcode
  • Simple Order API:
    invoiceHeader_merchantDescriptorPartnerIdCode

Service Location City Name

City name where a merchant provides a service that is not the merchant location.
Acquirers that support the service location city name must support the following data in the TC 33 capture file:
  • Record: CP12 TCR2
  • Position: 108–157
  • Field: Service Location City Name
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    invoiceHeader_serviceLocality
  • SCMP API:
    merchant_service_locality
  • Simple Order API:
    merchantInformation.serviceLocation.Locality

Service Location State/Province Code

State or province code where a merchant provides a service that is not the merchant location.
Acquirers that support the service location state/province code must support the following data in the TC 33 capture file:
  • Record: CP12 TCR2
  • Position: 158–-160
  • Field: Service Location State/Province Code
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.serviceLocation.countrySubdivisionCode
  • SCMP API:
    merchant_service_country_subdivision_code
  • Simple Order API:
    invoiceHeader_serviceCountrySubdivisionCode

Service Location Country Code

Country code where a merchant provides a service that is not the merchant location.
Acquirers that support the service location country code must support the following data in the TC 33 capture file:
  • Record: CP12 TCR2
  • Position: 161–163
  • Field: Service Location Country Code
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.serviceLocation.countryCode
  • SCMP API:
    merchant_service_country_code
  • Simple Order API:
    invoiceHeader_serviceCountryCode

Service Location Postal Code

Postal code where a merchant provides a service that is not the merchant location.
Acquirers that support the service location postal code must support the following data in the TC 33 capture file:
  • Record: CP12 TCR4
  • Position: 64–72
  • Field: Service Location Postal Code
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.serviceLocation.postalCode
  • SCMP API:
    merchant_service_postal_code
  • Simple Order API:
    invoiceHeader_servicePostalCode
Merchants
Merchants that support Mastercard must include these fields in their authorization request:
  • REST API:
    merchantInformation.merchantDescriptor.address1, merchantInformation.merchantDomainName, merchantInformation.merchantDescriptor.customerServicePhoneNumber, merchantInformation.taxId, merchantInformation.partnerId, invoiceHeader_serviceLocality, merchantInformation.serviceLocation.countrySubdivisionCode, merchantInformation.serviceLocation.countryCode, merchantInformation.serviceLocation.postalCode
  • SCMP API:
    merchant_descriptor_street, merchant_domain_name, merchant_descriptor_customer_service_phone_number, bill_merchant_tax_id, merchant_partneridcode, merchant_service_locality, merchant_service_country_subdivision_code, merchant_service_country_code, merchant_service_postal_code
  • Simple Order API:
    invoiceHeader_merchantDescriptorStreet, merchantDomainName, invoiceHeader_merchantDescriptorCustomerServicePhoneNumber, billTo_merchantTaxID, invoiceHeader_merchantDescriptorPartnerIdCode, merchantInformation.serviceLocation.Locality, invoiceHeader_serviceCountrySubdivisionCode, invoiceHeader_serviceCountryCode, invoiceHeader_servicePostalCode