It is now possible to define a qualifier on an Account Product record to establish conditions on not just 'when' it can be used, but to simultaneously have it be 'preferred' when that condition is met. This is very useful for more complex cases where merchants want to do tender steering with payments or similar automation.

Example

Don't tokenize when single use

In this example the merchant has two payment products, ACH and Token and a tokenize product. It's not uncommon for tokens to come with a cost or logistical complication and in scenarios where payments are being forgotten, they won't want them tokenized. You can use a qualifier on the ACH payment product to indicate it should be used only when a payment method is declared as single-use.

[
  {  
        "line": "tokenize",  
        "product": "ach",  
        "provider": "examplegateway",  
        "disabled": false,  
        "config": {  
            "applicationID": "63987",  
            "securityKey": "8WgMHRg3q"  
        }  
    },  
    {  
        "line": "payments",  
        "product": "token",  
        "provider": "examplegateway",  
        "disabled": false,  
        "config": {  
            "applicationID": "63987",  
            "securityKey": "8WgMHRg3q"  
        }  
    },  
    {  
        "line": "payments",  
        "product": "ach",  
        "provider": "Examplegatewayt",  
        "disabled": false,  
        "config": {  
            "applicationID": "63987",  
            // -- QUALIFIER EXMAPLE
             "qualifiers": {  
                "permissions": "single-use"
            }, 
            // -- QUALIFIER EXMAPLE   
            "securityKey": "8WgMHRg3q"  
        }  
    }
]

Card Brand Steering

A merchant could have two gateway processing partners that they would like to utilize. They would like all Visa, Mastercard and Discover payments to go to gateway 1, and AMEX to go to gateway 2. A qualifier for AMEX can be added to automate that steering.

[   
    {  
        "line": "payments",  
        "product": "creditcard",  
        "provider": "Examplegateway1",  
        "disabled": false,  
        "config": {  
            "applicationID": "63987",             
            "securityKey": "8WgMHRg3q"  
        }  
    },
    {  
        "line": "payments",  
        "product": "creditcard",  
        "provider": "Examplegateway2",  
        "disabled": false,  
        "config": {  
            "applicationID": "63988",  
            // -- QUALIFIER EXMAPLE
             "qualifiers": {  
                "brand": "amex"
            }, 
            // -- QUALIFIER EXMAPLE   
            "securityKey": "8WgMHRg3u"  
        }  
    } 
]

https://developer.authvia.com/v3.3/reference/create-account-product