Skip to main content

Required fields

Depending of different conditions, Tamaro automatically shows some blocks and fields, ignoring the values specified in showBlocks and showFields config options for these fields (or blocks in which these fields are rendered), and also makes them required.

This may be overruled by forceShowBlocks, forceShowFields and forcePaymentValidations config options, but if you use these config options, you MUST be sure to pass the data for all required fields by yourself (using hidden fields).

Current main rules:
(Tamaro actually has more rules, these are just the most important ones)

  • If payment type is recurring:
    • stored_customer_email is required
  • If payment method is card:
    • stored_customer_firstname is required
    • stored_customer_lastname is required
  • If payment method is sepa_dd:
    • stored_customer_email is required
    • stored_customer_firstname is required
    • stored_customer_lastname is required
    • if IBAN country is not in EEA (or equals to "FR"):
      • stored_customer_street is required
      • stored_customer_zip_code is required
      • stored_customer_city is required
      • stored_customer_country is required
      • stored_customer_state is required (if states are defined for selected country)
  • If payment method is direct_debit:
    • if direct debit variant is detected as sepa_dd:
      • stored_customer_email is required
      • stored_customer_firstname is required
      • stored_customer_lastname is required
      • if IBAN country is not in EEA (or equals to "FR"):
        • stored_customer_street is required
        • stored_customer_zip_code is required
        • stored_customer_city is required
        • stored_customer_country is required
        • stored_customer_state is required (if states are defined for selected country)
    • if direct debit variant is detected as ch_ta or ch_dd:
      • stored_customer_email is required
      • stored_customer_firstname is required
      • stored_customer_lastname is required
  • If payment method is ch_qr_reference:
    • stored_customer_firstname is required
    • stored_customer_lastname is required
    • stored_customer_street is required
    • stored_customer_zip_code is required
    • stored_customer_city is required
    • stored_customer_country is required
    • stored_customer_state is required (if states are defined for selected country)
  • If stored_customer_email_permission checkbox is checked:
    • stored_customer_email is required
  • If stored_is_company_donation checkbox is checked:
    • stored_customer_company is required
  • If donation receipt checkbox is checked and if donationReceiptRequiresFields config options is enabled (enabled by default):
    • If organisationCountryCode is "CH", "DE" or "US":
      • stored_customer_firstname is required
      • stored_customer_lastname is required
      • stored_customer_street is required
      • stored_customer_street_number is required
      • stored_customer_zip_code is required
      • stored_customer_city is required
      • stored_customer_country is required
      • stored_customer_state is required (if states are defined for selected country)
    • If organisationCountryCode is "AT":
      • stored_customer_firstname is required
      • stored_customer_lastname is required
      • stored_customer_birthdate is required
    • If organisationCountryCode is other or not specified:
      • stored_customer_firstname is required
      • stored_customer_lastname is required
      • stored_customer_street is required
      • stored_customer_zip_code is required
      • stored_customer_city is required
      • stored_customer_country is required
      • stored_customer_state is required (if states are defined for selected country)
  • If donation receipt checkbox is checked and autogeneratedDonationReceiptEnabled config options is enabled (disabled by default):
    • stored_customer_email is required