Test Types

The system supports 14 test types, each targeting a specific aspect of CitizenGO's donation forms and petition pages. Tests are created as ScheduledTest records in the admin panel.

Each test has: - Donation Form — Which form to test (a DonationLink record) - MD — Whether this is a monthly donation test (True) or one-time (False) - Arguments — Test-specific parameters (see each type below) - Recur in X days — Auto-schedule the next run after completion

Test Every Language

Key: testEveryLanguage

Tests whether the donation form is reachable from the main page of every language list (e.g. https://citizengo.org/pl).

• Donation Form: Does not matter which form is used
• Arguments: The list names to test

Test Currency Picker

Key: testCurrencyPicker

Tests whether each currency value is available in the currency picker dropdown on the donation form.

• Donation Form: Which form to test
• Arguments: N/A

Test Currency Picker Currencies

Key: testCurrencyPickerCurrencies

Tests whether the donation amount buttons update their currency symbols when different currencies are selected.

• Donation Form: Which form to test
• Arguments: N/A

Test Other Amount

Key: testOtherAmount

Tests whether the "other amount" input field works correctly on the donation form.

• Donation Form: Which form to test
• Arguments: N/A

Test Payment Methods

Key: testPaymentMethods

Tests whether all expected payment methods are available and usable on the form.

• Donation Form: Which form to test
• Arguments: Semicolon-separated list of expected methods, e.g. creditcard;ipayu;ipaypal;sepa

Test Payment Methods Order

Key: testPaymentMethodsOrder

Tests whether payment methods appear in the correct order (left to right, top to bottom).

• Donation Form: Which form to test
• Arguments: Semicolon-separated list in expected order, e.g. creditcard;ipayu;ipaypal;sepa

Test Form Fields

Key: testFormFields

Tests whether all personal information fields (name, address, email, etc.) are present on the form.

• Donation Form: Which form to test
• Arguments: N/A

Test Real Credit Card Donations

Key: testRealCreditCardDonations

Makes an actual credit card donation on the form. The donation is later verified through Salesforce via the Salesforce Check task.

• Donation Form: Use the dummy-segment form
• Arguments: email,amount,True,thank_you_amount e.g. someone@citizengo.net,501.17,True,501.1 — To skip the thank-you page check, use only 2 arguments: email,amount
• Important: Each test's donation amount MUST be unique across all real donation tests (for Salesforce matching). Amount must exceed the minimum and use dot-separated decimals.

Test Real Bank Donations

Key: testRealBankDonations

Makes an actual SEPA bank donation on the form, later verified through Salesforce.

• Donation Form: Which form to test
• Arguments: email,amount e.g. someone@citizengo.net,1.01
• Important: Same uniqueness rules as credit card donations.

Test Thank You Page

Key: testThankYouPage

This is not a real test. It's a system-generated marker created automatically by real donation tests. Do not schedule it manually.

Test Petitions

Key: testPetition

Tests whether petition pages load correctly for every region.

• Donation Form: Any (petitions use a different flow)
• Arguments: N/A

Test Petition Sign

Key: testPetitionSign

Signs one petition from one list, rotating through available lists daily unless a specific list is passed in the arguments. The test generates list-scoped +N aliases from the configured petition mailbox, then removes the created member from the remote database so the flow stays repeatable.

• Donation Form: Any
• Arguments: Optional list slug, e.g. en-us

Test Express Credit Card Donation

Key: testExpressCreditCardDonation

Tests whether the express donation form works for a member whose stored express payment method resolves to Stripe/credit card, then verifies the FRAPI donation uses STR.

• Donation Form: The express donation form
• Arguments: Optional amount as the second positional argument
• Configuration: EXPRESS_CC_DR_TOKEN and EXPRESS_CC_DR_EMAIL
• Scope: Stripe CitizenGO (cgo) only; US organization locales are skipped.

Test Express GoCardless Donation

Key: testExpressGoCardlessDonation

Tests whether the express donation form works for a member whose stored express payment method resolves to GoCardless, then verifies the FRAPI donation uses GC.

• Donation Form: The express donation form
• Arguments: Optional amount as the second positional argument
• Configuration: EXPRESS_GC_DR_TOKEN and EXPRESS_GC_DR_EMAIL

Test Browser Back/Forward

Key: testBrowserBackForward

DONUI-T-038: Tests browser back/forward navigation during the donation flow to ensure the form handles navigation correctly.

• Donation Form: Which form to test
• Arguments: N/A