Authorization Restrictions

Authorization Restrictions

Authorization Restrictions define blocking conditions that may apply to decline transactions on an Account.  
When an Account is created, the default Authorization Restrictions defined at the Product level are applied: 
the product initial setup defines the applicable restrictions and whether they are, by default, checked or not.  
Each applicable Authorization Restriction is identified by a specific "authorizationRestrictionReference".  

Standard Authorization Restrictions can be configured to decline (i.e. block) following use conditions: 
    w  acceptance channels: ATM / cash, POS, Card Not Present (e-Commerce, MOTO), recurring); 
    w  entry modes: contactless online, magnetic stripe; 
    w  business types (Merchant Category Code [MCC]); 
    w  countries or regions (geo-blocking).  
(NB this enumeration is informative, not normative, not exhaustive.)  

The "AuthorizationRestriction" objects contain the following properties: 
    w  "authorizationRestrictionReference", descriptive identification string; 
        (NB it is embedded in the "authorizationRestrictionIdentifier" object) 
        (used as parameter in the path of the operations related to the restriction) 
    w  "name", a (brief but hopefully meaningful) textual description for the restriction; 
    w  "conditionCheck", indicating if the condition is to be checked so the restriction applies; 
        (value as effective at operation execution time, esp. possibly changed via restriction override); 
    w  "conditionCheckOrigin", indicating from which level the "conditionCheck" has been taken; 
        esp. it will indicate whether the restriction has been overridden after the product initial setup; 
        (possible values as defined by enumeration: “Default”, “Exception”, “Override”, “Other”) 
    w  "conditionParameters", providing attributes, if any applicable, relating to the restriction; 
        (restriction criteria if relevant, merchant category code[s], country code[s], region code[s]) 
        (present if the "conditionCheck" is true, and if applicable to the condition to be checked) 
    w  "conditionParametersOrigin", indicating the level of the "conditionParameters" (if any); 
        (possible values as defined by enumeration: “Default”, “Exception”, “Override”, “Other”) 
        (present if the "conditionCheck" is true, and if the "conditionParameters" are present).  

Operations on Authorization Restrictions: 
("tags":["Account - Authorization Restriction"]) 
    w  List the Authorization Restrictions (for an account), 
    w  Retrieve an Authorization Restriction (by reference).  

Authorization Restriction Overrides

Authorization Restrictions can be changed by creating or updating Authorization Restriction Overrides.  
An Authorization Restriction Override is identified by its "authorizationRestrictionOverrideReference".  

The "authorizationRestrictionOverride" objects contain the following properties: 
    w  "authorizationRestrictionOverrideReference", its identification string; 
       (embedded in the "authorizationRestrictionOverrideIdentifier" object) 
       generated by Worldline at the Authorization Restriction Override creation; 
       (used as parameter in the path of the operations related to the override) 
    w  "authorizationRestrictionReference", overridden restriction identification; 
       (embedded in the "defaultAuthorizationRestrictionReference" object) 
       (used as parameter in the path of the operations related to its override[s]) 
    w  "deleted", indicating whether the override has been deleted or is still present; 
       remark: all of the properties hereafter are absent if the override is "deleted"; 
    w  "activationStartTime", the (first) point in time to start applying the override; 
       optional (if not provided, no delay to start: the override applies immediately) 
       must be before "activationEndTime" if any (can be present without an end time)
    w  "activationEndTime", the (last) point in time to stop applying the override; 
       optional (if not provided, no stop scheduled: the override applies endlessly) 
       must be after "activationStartTime" if any (can be present without a start time)
    w  "conditionCheck", indicating if the condition is to be checked so the override applies; 
       overrides the default configured on higher levels for the initial authorization restriction; 
       if set to “null”, the default value configured for the authorization restriction is effective; 
    w  "conditionParameters", providing attributes, if any applicable, relating to the override; 
       override the default configured on higher levels for the initial authorization restriction; 
       if set to “null”, the default values configured for the authorization restriction are effective; 
    w  "priority", used to apply overrides in ascending order of "priority" (from lowest to highest) 
       in case of different overrides - on a same restriction - whose effective timespans overlap; 
       must be different for all co-occurring overrides (not if they are never effective simultaneously) 
       (if not provided, will be set to 0).  

Operations on Authorization Restriction Overrides: 
("tags":["Account - Authorization Restriction"]) 
    w  List the Authorization Restriction Overrides (for an account), 
    w  Create an Authorization Restriction Override (for an account), 
    w  Retrieve an Authorization Restriction Override (by reference), 
    w  Update an Authorization Restriction Override (for an account), 
    w  Delete an Authorization Restriction Override (for an account).  
.