Home / Auctions for Salesforce

Auctions for Salesforce


In Groundwire Auctions for Salesforce version 3.0 the option to use Click & Pledge as a payment processor has been added. So now, at your auction your patrons can be pre-authorized then charged for their items purchased at the end of the event. Since this will be using the Click & Pledge  Payment as a Serive App, receipts will be automatically emailed to patrons and the organization per usual. And the transaction will be recorded under the Contact's record. 

In order to use Click and Pledge with Groundwire Auctions for Salesforce version 3.0 and higher you need to have:
  • Install Auctions for Salesforce App & follow the installation instruction as provided by the application.  [see documentation]
  • Presumably you should already have a Click & Pledge Account and have installed the Click and Pledge Payment as a Service App on Salesforce. If you have not, you would need do this first.
  • Created an Embedded Virtual Terminal within the Click and Pledge app
  • Complete the 'After Installing' and 'Integrating with a Payment Processor' instructions also available within Groundwire's Install & Configuration Guide. For this you will need to add your Click & Pledge embedded virtual terminal ID and Click & Pledge account ID within custom settings. 

Auctions Integration

Auctions integration consists of three steps:

  1.  Integration
  2.  Embedded Virtual Terminal creation
  3.  Custom Settings 

First Step: Integration: 

In integration process we have two more steps. One is to integrate Click & Pledge to Salesforce and another one is to integrate Salesforce to Click & Pledge.

Step 1.1: Click & Pledge to Salesforce

Portal Settings

Step 1: Login to portal with Email address & Password.

Step 2: Click on Account Info.

Step 3: Click on 3rd Party.

Step 4: To run Auctions, Sf eVt information should be updated successfully. Click on Sf eVt.

Step 5: Enable the checkbox to integrate Click & Pledge to Salesforce.

Step 6: Select the Account type by clicking on the radio buttons.

NOTE: If you are login through login.salesforce.com then it is Production type. If you are login through test.salesforce.com then it is sandbox type.

Step 7: Enter the Salesforce user name and password (twice).

Step 8: To know your Token id, go to Personal Setup > My Personal Information > Reset My Security Token and click on “Reset Security Token” button. An email will be sent to the registered email account. In that email, you will find the token. Copy and paste the token here.

Step 9: To find the organization ID follow the path: Login to Salesforce > Setup > Company Profile > Company Information > Salesforce.com Organization ID. Copy and paste it here.

Step 10: After entering all the details then click on “Verify & Update” button.

Step 11: Make sure that you will see the successful message.

Step 1.2: Salesforce to Click & Pledge

Salesforce Settings

Step 1: Login to Salesforce and click on the “C&P Settings” tab.

Step 2: Click on the “C&P Account” tab.

Step 3: Type a name for internal reference.

Step 4: Copy and paste the account number from the portal. Account Info > Profile > Your Profile > API Information.

Salesforce Info

Step 5: Copy & paste the “Account GUID” from above.

Step 6: Select “Active” from the account status. Only active accounts may be used in the VT and event.

Step 7: Select the currency set for the account. Click & Pledge accounts are set up with a specific currency. Make sure to select the correct currency.

Step 8: Click on “Add/Update” to save the record.

An unlimited number of Click & Pledge accounts may be added in this section.

Second Step: Embedded Virtual Terminal Creation

Creation of eVT

Step 1: Click on the “C&P Embedded Virtual Terminal” tab. If you don’t find the tab on the menu bar then click on “All Tabs (+)” button and select from the list.

Step 2: Click on “New” to create one Embedded Virtual Terminal.

eVT Settings

Step 3: Application Information: Enter the desired Application name, version number and identification number.

Step 4: Enter the Page name.

Step 5: C&P Account Number: Select the desired C&P Account number from the drop-down menu.

NOTE: The drop-down menu will appear only when you have more than one C&P Account.

Step 6: Terms & Conditions:

Show Terms & Conditions: If this checkbox is enabled then terms & conditions will be displayed in the external page and vice versa.

Show Acknowledgement Mandatory: If this checkbox is enabled then a checkbox will appear before Terms & Conditions in an external page. Only after enabling this checkbox, Process Payment button will be enabled.

External eVT Page

Step 7: Terms & Conditions Text: The text which is entered here will be displayed in the external page (Only if the checkbox for “Show Terms & Conditions” is enabled in Step: 6).

Step 8: Payment Methods: Enable the checkbox for online payments to which you opted to display in the external page.

Step 9: Messages:

Thank you: The text entered here will be displayed after the successful transaction in the external page.

Payment Declined: The text entered here will be displayed after the unsuccessful transaction in the external page.

Step 10: Receipt Customization: Whatever text given here will be seen in receipt mail.

NOTE: Receipt does not support images in the body of the text.

Step 11: Object Settings: Select the settings based upon the requirement.

Step 12: After entering all the details, click on “Save” button. You will find “Base URL” in Page Information.

Third Step: Custom Settings

Login to Salesforce account and follow the path: Setup > App Setup > Develop > Custom Settings.

Custom Settings

Click on “Manage” button then you will be redirected to the AuctionSettings page. Click on “New” button.

Auctions Settings Edit

Step 1: Enter the desired name. It will be used when the custom settings data is referenced by Apex.

Step 2: Credit Card Charge URL Formula: This URL invokes the virtual terminal of a credit card processor to charge their credit card. Go to Embedded Virtual Terminal page and find the Base URL in Page information.

Base URL

https://evt.salesforce.cloud.clickandpledge.com?SFOrgID={5} &SFeVTID=<Paste 1>&CnPAID=<Paste 2> &SFContactID={0}&b1=Auction Purchases&up1={2}&showTotal=1 &SessionId={3}&ServerURL={4}

Copy and paste the above URL in the textbox. Make sure to change <Paste 1> with your eVTID and <Paste 2> with your C&P Account Number.

Step 3: Credit Card Validate URL Formula: This URL invokes the virtual terminal of a credit card processor to capture and validate their credit card info. Like above, copy and paste the below URL by giving eVTID and C&P Account Number from the Base URL of Embedded Virtual Terminal.

https://evt.salesforce.cloud.clickandpledge.com?SFOrgID={5} &SFeVTID=<Paste 1>&CnPAID=<Paste 2>&SFContactID={0}&b1=Auction Validation Only&up1=0&PreAuth=1&subtxt=Save Payment Info

Step 4: Opportunity Payment Method Field: It helps to know which payment type (Credit Card, eCheck, Cash) is using.

If the user has the NPSP they should leave it blank, and Auctions for Salesforce will automatically save the payment method on the Payments object (if they have NPSP payments enabled).

If the user is not using NPSP then follow the below procedure to know the Opportunity Payment Method Field: Login to the Salesforce account then Setup > App Setup > Customize > Opportunities > Fields > Opportunity Custom Fields & Relationships > New

Opportunity Custom Fields & Relationships

Step 4.1: Choose the field type

Select “Text” data type and click on “Next” button.

Field Type

Step 4.2: Enter the details

Enter the desired field label. Make sure that the length should not exceed 255. The field label will be automatically considered as its field name.

Field Label Details

Step 4.3: Establish field-level security

Just click on “Next” button to advance to the final step.

Field Level Security

Step 4.4: Add to page layouts

Click on “Save” button to save the settings.

Add to Page Layouts

After clicking on “Save” button, you will be redirected to the “Opportunity Fields” page. Scroll down to find “Opportunity Custom Fields & Relationships” tab and you will find the newly created field label. Copy the “API name” and paste it in the “AuctionSettings Edit” page.

Auctions Payment Method 

NOTE: If Opportunity Payment Method Field is empty then you will see the following error.

Opportunity Error

NOTE: If they want to track Payment Method on some other custom related object, they can't do it directly.  Ie, A4S won't know how to write to a related record.  They would need to have a custom field on Opportunity, which they specify as described above, and then they could use their own flow, process, or trigger to copy their Opportunity Payment Method field to their related object.

Step 5: Opportunity Stage Pledged: This opportunity stage will be used when the auction purchases are pledged, but not yet paid.

To see whether the stage name is correct or not, follow these steps: Setup > App Setup > Customize > Opportunity > Fields > Opportunity Standard Fields > Stage (Click on Stage) > Opportunity Stages Picklist Values. You will find the “Pledged” under Stage name category.


NOTE: Check whether the spelling “Pledged” in Opportunity Stages Picklist values and AuctionSettings Edit page is same.

Step 6: Opportunity Stage Won Not Thanked: This opportunity stage will be used when the opportunities are paid but not thanked.

Follow the Step 5 guidelines to check whether the name is same in both Opportunity Stages Picklist Values and AuctionSettings Edit page.

NOTE: Make sure that the Hyphen size is same. It is recommended to copy the stage name from the Opportunity Stages Picklist Values and paste it in the AuctionSettings Edit page.

Closed Won

NOTE: There are two scenarios in which Pledged & Closed Won stages will not appear.

Case 1: When the stage is not even created in Salesforce:

To create stages follow this path: Setup > App Setup > Customize > Opportunities > Fields > Opportunity Standard Fields > Stage (Click on it) > Opportunity Stages Picklist Values > New

Enter the appropriate values to create a new stage. Make sure that the stage is added to Auctions in “Sales Processes” and click on “Save” button.

Opportunity Stages Settings

NOTE: If this is the scenario then no need to go for the Case: 2.

Case 2: when these stages were created but not added into Sales Processes of Opportunity from Salesforce:

If you want to see whether it is already created in Salesforce or not then follows this path: Setup > App Setup > Customize > Opportunities > Sales Processes > Auctions (Click on Auctions) > Opportunity Stages.

Select “Pledged” & “Closed Won – Not Thanked” from “Available Stages” section and click on “Add” button. Then those two will come under “Selected Values” section. Then click on “Save” button then these two stages will appear on the Auctions page.

Sales Processes

Step 7: After entering the details, click on “Save” button to save the Custom Settings.

NOTE: If you need any support in installation process, please raise a ticket in the forum and grant us the access.

     RSS of this page