Skip to content

Dynamic 3-D Secure rules

Decide per project when a card payment asks for 3-D Secure, based on the country that issued the card.

By default, Ginger authenticates every card payment with 3-D Secure (3DS), except merchant-initiated transactions. With dynamic 3DS rules you change that per project: for example, prefer not to request 3DS for cards issued outside the EEA, where Strong Customer Authentication doesn't apply.

For projects that process cards through Silverflow or Rapyd. The rules live in the project's contract of that processor.

How rules work

A rule has a name, one or more conditions, an action, and an on/off switch.

PartOptions
ConditionThe country that issued the card is one of (in) or is not one of (not_in) a list of countries (ISO 3166-1 alpha-2 codes)
ActionAlways request 3DS (always) or Prefer not to request 3DS (prefer_not)
EnabledOnly enabled rules are evaluated

Ginger evaluates the rules when a card payment starts:

flowchart
  • The rules are evaluated in order. The first enabled rule whose conditions all match decides; later rules are ignored.
  • When no rule matches, or when Ginger can't determine the issuing country, the payment asks for 3DS.
  • Rules apply to card payments (credit-card) and Google Pay (google-pay).
  • Prefer not is a preference, not a guarantee: whether the payment is authenticated without 3DS also depends on the processor and the issuer.

The result is recorded on the transaction as a dynamic_3ds_determined event, with dynamic_3ds_result set to skip_3ds or require_3ds.

Add rules

  1. Open the merchant, go to Projects and open the project.
  2. Open the Payment Method Contracts tab and click the Silverflow or Rapyd contract.
  3. Edit the contract. In the dynamic 3DS rules field, add a rule:
    • Name: a label, for example Non EU cards, skip 3DS.
    • Enabled: tick Evaluate this rule on incoming payments.
    • Conditions: pick is one of or is not one of and the countries. All conditions must match.
    • The action: Always request 3DS or Prefer not to request 3DS.
  4. Order the rules with the arrows. The first matching rule wins.
  5. Click Save contract.