Add Mailchimp Account to Mandrill

Note: Only a paid monthly MailChimp plan will meet the requirements. Purchasing Mandrill blocks will incur monthly charges in addition to your MailChimp plan.

See: https://mandrill.zendesk.com/hc/en-us/articles/205583067-How-do-I-use-Mandrill-if-I-already-have-a-MailChimp-account-

1. Login to MailChimp: https://login.mailchimp.com
2. Go to Account -> Integration
3. Select Mandrill and click "Authorise connection"
4. Login with your Mandrill account and allow MailChimp as an App. 

Create a Template via MailChimp (based on an example template)

1. A boiler plate for the templates will be provided by RaiseNow.
2. Log into your MailChimp account
3. Click on Templates → create template → code your own → Import HTML
4. Define a name for the template "raisenow-donation-email-[2-letter-language-iso]" and add the .html-file you just downloaded (note that you will need one template for each language; the name on Mandrill will be the same as in Mailchimp); then click upload.
5. When the file is uploaded, MailChimp will take you directly into an editor allowing adopt the template to your organisation and needs. 
   1. The template is now in Mailchimp and can also be accessed from the Templates list without having to repeat the previous steps.
   2. Mailchimp takes you into an editor which shows the template's HTML-Code, try switching the editor to "edit design" on the bottom row to switch to a WYSIWYG-editor.
6. Once finished editing, click "save and exit"; which will take you back to the Template list - do not forget to push the templates to Mandrill to actually deploy the new or updated template by clicking on the dropdown beside the template's edit-button and select "Send to Mandrill".
7. If you have not already done so or if you have configured a new template name: 
   1. Note down the template name and Mandrill credentials and send them to support@raisenow.com to make the required changes to the widget-configurations. 

Providing credentials to RaiseNow

Within Mandril (not MailChimp), under Account → Settings you can generate a new API key for RaiseNow. RaiseNow will need

• the SMTP username,
• any valid API key
• a valid sender address, i.e. no-reply@NPO.org 
• a sender name

to trigger sending emails through Mandril. 

Please provide this data in a password protected zip file via ticketing (support@raisenow.com) and send the password for the zip file to your contact via a different channel. 

Test emails

Emails can be tested using curl by making a GET request to RaiseNow'S API:

• replace the parameter stored_widget_uuid=futuragoal with the id of the widget to test
• replace stored_customer_email=john.doe@raisenow.com with a valid email address to receive the emails
• for subscription events, also replace the parameter event=subscription_subscribe with the event you want to test

One-off Donation

The "transaction changed to final success" email is triggered after the donation is transmitted. It contains the payment method, the amount and the name of the donor.

https://widget.raisenow.com/widgets/lema/_default/mail.php?dds-show-email=true&stored_rnw_product_name=lema&stored_rnw_widget_uuid=futuragoal&test_mode=true&stored_customer_email=doe@raisenow.com&amount=100&payment_method=vis&event=transaction_status_changed_to_final_success&masked_cc=23XXX4&stored_rnw_source_url=http://www.test.ch&stored_customer_lastname=Doe&stored_customer_firstname=John&language=en&stored_customer_salutation=mr&new_status=final_success&currency=chf

Recurring Payments (subscription events)

The following events may trigger emails and should, therefore, have a working template in place:

• subscribe
• charged
• charged error
• cancel
• renew

Subscribe

You can find the subscription_token in the URL. It is needed if you want to test the page where the donator can change his personal data, for example, to change the credit card.

https://widget.raisenow.com/widgets/lema/_default/mail.php?dds-show-email=true&stored_rnw_product_name=lema&stored_rnw_widget_uuid=futuragoal&test_mode=true&stored_customer_email=doe@raisenow.com&amount=100&payment_method=vis&subscription_id=213&interval=01%2000%20L%20*%20*&event=subscription_subscribe&masked_cc=23XXX4&charges_count=1&stored_rnw_source_url=http://www.test.ch&subscription_token=11111&stored_customer_lastname=Doe&stored_customer_firstname=John&language=en&stored_customer_salutation=mr&new_status=final_success

Charged

The interval of the donation and the donation count (charges_count) is added. In addition, a link is sent to edit the personal data or to cancel subscription.

https://widget.raisenow.com/widgets/lema/_default/mail.php?dds-show-email=true&stored_rnw_product_name=lema&stored_rnw_widget_uuid=futuragoal&test_mode=true&stored_customer_email=doe@raisenow.com&amount=100&payment_method=vis&subscription_id=213&interval=01%2000%20L%20*%20*&event=subscription_charged&masked_cc=23XXX4&charges_count=1&stored_rnw_source_url=http://www.test.ch&subscription_token=11111&stored_customer_lastname=Doe&stored_customer_firstname=John&language=en&stored_customer_salutation=mr&new_status=final_success

Charge Error

The interval of the donation is added and the link to edit the personal data (or cancel subscription) is sent.

https://widget.raisenow.com/widgets/lema/_default/mail.php?dds-show-email=true&stored_rnw_product_name=lema&stored_rnw_widget_uuid=futuragoal&test_mode=true&stored_customer_email=doe@raisenow.com&amount=100&payment_method=vis&subscription_id=213&interval=01%2000%20L%20*%20*&event=subscription_charge_error&masked_cc=23XXX4&charges_count=1&stored_rnw_source_url=http://www.test.ch&subscription_token=11111&stored_customer_lastname=Doe&stored_customer_firstname=John&language=en&stored_customer_salutation=mr&new_status=final_success

Cancel

event=subscription_cancel

https://widget.raisenow.com/widgets/lema/_default/mail.php?dds-show-email=true&stored_rnw_product_name=lema&stored_rnw_widget_uuid=futuragoal&test_mode=true&stored_customer_email=doe@raisenow.com&amount=100&payment_method=vis&subscription_id=213&interval=01%2000%20L%20*%20*&event=subscription_cancel&masked_cc=23XXX4&charges_count=1&stored_rnw_source_url=http://www.test.ch&subscription_token=11111&stored_customer_lastname=Doe&stored_customer_firstname=John&language=en&stored_customer_salutation=mr&new_status=final_success

Renew

event=subscription_renew

https://widget.raisenow.com/widgets/lema/_default/mail.php?dds-show-email=true&stored_rnw_product_name=lema&stored_rnw_widget_uuid=futuragoal&test_mode=true&stored_customer_email=doe@raisenow.com&amount=100&payment_method=vis&subscription_id=213&interval=01%2000%20L%20*%20*&event=subscription_renew&masked_cc=23XXX4&charges_count=1&stored_rnw_source_url=http://www.test.ch&subscription_token=11111&stored_customer_lastname=Doe&stored_customer_firstname=John&language=en&stored_customer_salutation=mr&new_status=final_success