Enhanced Provisioning Rules

Consult this page to see which parameters to set to send a mobile-wallet tokenization request down either the red path or the yellow path.

Red path — Decline provisioning requests

Set each parameter to initiate the red path for provisioning requests when the rule is triggered. The fields specified in the Rules column are nested in the tar_info object of the Auth API.

ParameterDescriptionRule
TWRRCTokenization Wallet Recommendation Red Checktokenization_recommendation is:
  • 0 (decline) — Mastercard
  • 2 (not approved) — Visa
  • TASRCTokenization Account Score Red CheckMastercard or Visa: account_score: 1
    TRCRCTokenization Reason Codes Red CheckMastercard only. tokenization_recommendation_reason_code_parsed is:
  • 10 — Excessive recent tokenizations on device
  • 11 — Excessive non-matching cardholder names on device
  • 12 — Low device score
  • 16 — High-risk digitization attempt
  • TVSCKTokenization Visa Score CheckVisa token score is greater than or equal to 85.
    TALCKTokenization Attempt Limit CheckLimit the number of times a token can be deleted and re-provisioned within a given period.

    Yellow path — Send one-time passcode

    Set each parameter to initiate the yellow path for provisioning requests when the rule is triggered. The fields specified in the Rules column are nested in the tar_info object of the Auth API. By default, all provisioning requests with device_score: 2 will enter the yellow path.

    ParameterDescriptionRule
    TWRYCTokenization Wallet Recommendation Yellow Checktokenization_recommendation is:
  • 2 — Requires additional authentication (Mastercard)
  • 1 — Conditionally approved with further verification (Visa)
  • TTTCKTokenization Token Type (Visa Only)token_type: H
    TASYCTokenization Account Score Yellow CheckMastercard or Visa: account_score: 2
    TEMCKTokenization Entry Mode CheckPAN was manually entered or a picture was taken of the card with a camera. (Visa)
    TRCYCTokenization Reason Code Yellow CheckMastercard tokenization_recommendation_reason_code_parsed is:
  • 05 — Suspicious transactions linked to this account.
  • 07 — Device contains suspended tokens
  • 08 — Device recently reported lost
  • 09 — Excessive recent tokenization attempts on device
  • 13 — Low account score
  • 14 — Non-domestic tokenization attempts

    Visa tokenization_recommendation_reason_code is:
  • 03 — Cardholders’ wallet account/card pair is newer than date threshold.
  • 05 — Suspicious transactions linked to this account.
  • 07 — Suspended cards in the secure element.
  • 08 — Device was put in lost mode for longer than the duration threshold within the last 7 days
  • 09 — The number of provisioning attempts on this device in 24 hours exceeds the threshold
  • 0A — There have been more than the threshold number of provisioning attempts for different cards on this phone in 24 hours.
  • 0G — Suspected fraud