ProntoGiving - additional configuration
On this page
Hide Unused/Deprecated Components
Navigate to Setup | Users | Choose Profile. (Note: Do to all Profiles or a specific profile
that you want to hide those tabs)
Click Edit
Go to Tab Settings section and hide the following tabs if visible:
DEPRECATED - BDE Wizard 2.0
DEPRECATED-ProntoPayments Settings
DEPRECATED - Bulk Donation Templates
Deprecated ProntoPayments Settings
DEPRECATED - ProntoGiving Settings2
DEPRECATED-Manage ABA Files
Bulk Donation Entry Wizard v1.0
Bulk Donations (v1.0)
Receipt Templates
Consolidated Statements
Consolidated Statements Settings
Quick Donate 1
Batch Data Entry
Quick Donate
Setup Process Type for Payment Transaction
Go to Setup | Object Manager | Payment Transactions | Fields & Relationships | Process Type
Make sure that the Manual Payment and Via ProntoPayments are active in the picklist values section.
Setup Field Dependencies on Process Type
Go to Setup | Object Manager | Payment Transactions | Fields & Relationships | Process Type
Edit the Field Dependencies
Under Manual Payment select:
Cash
Cheque
Bank Account
Credit Card
Under Via ProntoPayments select:
Bank Account
Credit Card
Enable the Manual Payment record type
Go to Setup | Object Manager | Payment Transaction | Record Types | Manual Payment | Edit
Setup Cash record type
Process Type
Go to Setup | Object Manager | Payment Transactions | Record Types | Cash | Process Type → Edit
Ensure Manual Payment and Via ProntoPayments are in the Selected Values column
Payment Type
Ensure all values are in the Selected Values column
Go to Setup | Object Manager | Payment Transactions | Record Types | Cash | Edit Payment Type
Card Expiry Month
Ensure all values are in the Selected Values column
Go to Setup | Object Manager | Payment Transactions | Record Types | Cash | Edit Card Expiry Month
CardType
Ensure all values are in the Selected Values column
Go to Setup | Object Manager | Payment Transactions | Record Types | Cash | Edit Card Type
Payment Status
Ensure all values are in the Selected Values column
Go to Setup | Object Manager | Payment Transactions | Record Types | Cash | Edit Payment Status
Setup Manual Payment record type
Follow the same steps as Cash record type
Setup Field Sets
This section uses the Field Sets section found under Setup | Object Manager | Opportunity. For each field set type, select Edit and display the following fields:
One-Off Donation
Close Date
Lead Source
Stage
Primary Campaign Source
Receipt Action (PPlus)
Receipt Template (PPlus)
Recurring Donation
Recurring Type
Date Established
Installment Period
Installment Frequency
Day Of Month
Number of Planned installments
Receipt Action (PPlus)
Receipt Template (PPlus)
Campaign
QD New Contact Fieldset
First Name
Last Name
Email
Work Email
Personal Email
Alternate Email
Receipt Email (PPlus)
Receipt Action Preference (PPlus)
QD Existing Contact
First Name
Last Name
Mailing Street
Mailing City
Mailing Country
Mailing State/Province
Mailing Zip/Postal Code
Phone
Email
Work Email
Personal Email
Alternate Email
Receipt Email (PPlus)
Receipt Action Preference (PPlus)
QD New Account Fieldset
Account Name
Receipt Recipient (PPlus)
QD Existing Account Fieldset
Billing Street
Billing City
Billing State/Province
Billing Zip/Postal Code
Billing Country
Receipt Recipient (PPlus)
QD Credit Card Fields (This is only optional because not all gateways require CCV field)
Add CCV (PPlus) field
Additional Information for Quick Donate
If Account is existing/new and the Donation Type is equal to Household or Organisation, the account should have Primary Contact or Receipt Recipient (PPlus) as the value.
If Contact is existing/new and the Donation Type is equal to Individual, the contact should have Receipt Email (PPlus) as the value.
Setup Default Values
Set the default values in your Quick Donate Page.
Go to ProntoGiving Settings | Donation | Quick Donate. These will be set by the client
Setup Sales Process
Go to Setup | Feature Settings | Sales | Sales Process
Ensure that the Pledged or Prospecting stage is selected in your active Sales
Processes
Set Default Record Type to Cash
Go to Setup | Profile | System Admin | Object Settings | Payment Transactions
Set the default record type to Cash.
Donation Fields Mapping
Donation Fields Mapping is a mapping to use for Quick Donate and Batch Donation Entry.
Go to ProntoGiving Settings | Donation Fields Mapping.
Create new mapping by clicking the New button.
Add the mapping below
Donation Type (PPlus)
Receipt Action (PPlus) - for clients that use Wordpress in their Donation Form.
Barcode
Go to ProntoGiving Settings | Donation | Settings | Barcode
Enable the barcode. Once enabled, the barcode field will display in the Quick Donate and Batch Donation Entries page.
Unique ID Campaign Member Field Name - It will recognised the campaign based on what was being setup in the BDE Template. a. Scenario: If the user chooses Barcode Number field the workaround will be; In order to recognise all campaigns with its campaign member barcodes, untick the Campaign as required and remove the campaign from the default list in all templates
Unique ID Account Field Name - scans a matching value on the field specified for Account
Unique ID Contact Field Name - scans a matching value on the field specified for Contact
Unique ID Recurring Donation Field Name - scans a matching value on the field specified for Recurring Donation.
Access permissions
Set these permissions for users to access Quick Donate.
Object | Object Permission | Field Permission | Read Access | Edit Access |
Accounts | Read, Create | Billing Address Receipt Recipient (PPlus) | TRUE | TRUE |
Campaigns | Read, View All |
|
|
|
Contacts | Read, Create | Alternate Email Mailing Address Personal Email Receipt Action Preferences (PPlus) Receipt Email (PPlus), Work Email | TRUE | TRUE |
Gateways | Read |
|
|
|
GAU Allocations | Read, Create | Amount Percent | TRUE | TRUE |
General Accounting Units | Read |
|
|
|
Opportunities | Read, Create | Lead Source Receipt Action (PPlus) Receipt Template (PPlus) | TRUE | TRUE |
Payment Sources | Read, Create | All fields | TRUE | TRUE |
Payments | Read | All fields | TRUE |
|
Payment Transactions | Read, Create | All fields | TRUE | TRUE |
Receipt Template (PPlus) | Read | All fields |
|
|
Recurring Donations | Read, Create | Always use last day of month Campaign Date Established Department Exclude in RD Monitoring Installment Period Lead Source Number of Planned Installments Open Ended Status Receipt Action (PPlus) Receipt Template (PPlus) Schedule Type | TRUE | TRUE |
Visualforce Page access | ASPHPPADDON.QuickDonate2 | |||
ProntoGiving Settings
Setup Opportunity Stages
a. Go to ProntoGiving Settings | Donation | Stage and set according to the client requirements
Setup Settings
Go to ProntoGiving Settings | Donation | Settings and make changes to the following according to the client requirements:
Enable Default Campaign
Anonymous Contact
One-Off Record Type.
Recurring Donations
Go to ProntoGiving Settings | Recurring Donations | Recurring Donation Naming
Setup Recurring Donation Naming.
Setup Update Payment Sources
NPSP Phone and Email Work Flow
These Phone and Email Work Flow Rules should be turned on by default.
Email Workflow Rule
Contact.EmailChanged_Alternate
Contact.EmailChanged_Personal
Contact.EmailChanged_Work
Contact.Preferred_Email__c
Email only: Paste to Work
Phone Workflow Rule
Contact.PhoneChanged_Home
Contact.PhoneChanged_Mobile
Contact.PhoneChanged_Other
Contact.PhoneChanged_Work
Contact.Preferred_Phone__c
Phone only: Paste to Work
Go to Setup > Workflow Rules. Click Activate the workflow rule’s name.
Remote Site Setup
Update Remote Site - Metadata
Setup Remote Site Settings
Switch to Classic Environment
Go to ProntoGiving Settings and copy the highlighted link below.
Note: Every org has a different URL
Go to Setup > Security > Remote Site Settings. Update Metadata Remote Site
Make sure that the “Active” checkbox is ticked and save when done.
Trigger Handlers
Note: Ensure these triggers are added and activated. Adjust the load order accordingly if the client is not using the other features.
Go to App Launcher | Trigger Handler
The PP_ASPaymentTXN_TDTM trigger handler requires ProntoPayments version 2.7 or
higher
Add the PP_Opportunity_TDTM trigger handler if:
The org has NPSP installed, if none, don’t add
Once the trigger is added, enable the NPSP TDTM toggle in ProntoPayments Settings
Load Order should be ProntoPayments, ProntoGiving, ProntoPlus and org customisation for every object.
Please note: all triggers should be Active.
Trigger Handler Name | Object | Class | Load Order | Trigger Action | Asynchronous After Events | Purpose |
|---|---|---|---|---|---|---|
PGIV_ASPaymentRefund_TDTM | ASPHPP__ASPayment_Refund__c | ASPHPPADDON.PGIV_ASPaymentRefund_TDTM | 1 | AfterInsert; AfterUpdate |
| Holds the process for the refunding of a payment It will create a Negative GAU record |
PP_ASPaymentTXN_TDTM | ASPHPP__ASPayment_TXN__c | ASPHPPADDON.ProntoPayments_ASPaymentTXN_TDTM | 1 | BeforeInsert; BeforeUpdate; AfterInsert; AfterUpdate | If Asynchronous is true cannot process payment. | After creating/updating the Opportunity record, the Last Payment Transaction field will be populated based on the Payment Transaction of the Opportunity After refunding a payment in Payment Transaction record, the negative Payment Transaction record is populated based on the values from the Payment Refund |
PGIV_RecurringDonation_TDTM | npe03__Recurring_Donation__c | ASPHPPADDON.PGIV_RecurringDonation_TDTM | 3 | BeforeInsert; BeforeUpdate; AfterInsert |