Step 2 - Choose OmniToken format

Document created by gjsissons on Jul 20, 2016Last modified by lkilligrew on Aug 17, 2016
Version 11Show Document
  • View in full screen mode

At the core of enabling Vantiv’s in-app integration is the generation and use of an OmniToken. OmniTokens offer a shorter “formed-preserved” reference to the cardholder’s credit card number with the actual card data being stored in Vantiv’s secure vault.  The advantages to this method of tokenization is that it allows for easy access to programs and features that were never possible before—including eProtect for eCommerce and Apple Pay In-App.


For MercuryPay integrations, the OmniToken is used in place of MToken (RecordNo). One additional tag, <TokenType> is used in the transaction request.


Choose the OmniToken Format


OmniTokens generated over the eProtect platform come in several different formats. When using them for MercuryPay, the MOD10+1 formats are preferable as they can be used to distinguish the first 6 and last 4 characters of the PAN. We recommend using either of the two formats below:


  • Format T: Informative A1. Duplicates the length of the original PAN and preserves the first-six and last-four of the PAN. For example, if the original PAN is 14 characters long, the OmniToken will be 14 characters.
  • Format D: Minimum 16A 1. Length is 16 if the original PAN is 16 characters or less, but can be up to 19 characters if the original PAN is that length. For example, if the original PAN is 14 digits long, the OmniToken will be 15 characters; if the original PAN is 19 characters, the OmniToken will be 19 characters.



Previous: Step 1 - Integrate to Apple Pay

Next: Step 3 - Integrate to MercuryPay


Return to In-App for MercuryPay home page