Ecommerce Token Processing in Meta Pay

This document describes how to process the ecom-token-v1 payment container type when you integrate with Meta Pay. The payment instrument delivered in this container is an ecommerce token also referred to as network token. Ecommerce tokens are a replacement for processing online payments using cards without using PAN data. Meta Pay operates as a Token Requestor and handles tokenization of user cards with payment networks - specifically Visa and Mastercard.

Please note the following Mastercard disclosure: Mastercard, through Cloud Token Offering, provides tokenization as an incentive to merchants (and aggregators and developers acting on behalf of merchants) to enable secure remote payments. The incentive is offered to (a) advance the adoption of this technology-enabled payment option; and (b) route transactions through such card network’s systems and networks. As such, you, as a merchant (or aggregator or developer acting on behalf of a merchant) may opt in to the token value-added transaction type and route to Mastercard. If you do not want to route to Mastercard in exchange for this incentive, then you can accept debit card payments in a more traditional interface that also allows for a routing choice.

For more general information, see Overview of Meta Pay Integration. See Payment processing for information common to all container types.

Container Data Example

The following is an example of container data for a ecom-token-v1 container:

{
   container_type: 'ecom-token-v1',
   created_time: 1582230020020,
   merchant_id: '123e4567-e89b-12d3-a456-426614174000',
   container_context: '76077dca-8c57-4536-bf48-30bd3f02196e',
   token_data: {
     account_holder_name: '<name>',
     brand: 'visa',
     number: '5413339000001513',
     expiry_month: '12',
     expiry_year: '2022',
     cryptogram: 'AlhlvxmN2ZKuAAESNFZ4GoABFA==',
     eci: '0',
}

Container Data Details

The following defines the structure of container data for ecom-token-v1: