Checkout Process
  • 19 Sep 2022
  • 3 Minutes to read
  • Dark

Checkout Process

  • Dark

Data Dictionary Update

The Data Dictionary feature will work with the new Checkout process, allowing other languages to be used as they are in the rest of the Events app.

The process below lets you know, as an internal Salesforce Events user, what happens when someone completes an Event checkout.

Salesforce Event Registration Process

  1. START

    • Step 1: Attendee completes the Checkout process from the Event.

    • Step 2: A Payment Method record is added to Salesforce with the Card ID (i.e the token).
    • Step 3: A Transaction is created and authorized (processed/charged).

    • Step 4: A Event Registration Submission (ERS) record is created as a JSON file captures all related data.

D_06_SF Event Reg Process


    • Step 5: An Attendee record is created and related to the Event record.
    • Step 6: Attendee's Registration Status is updated to "Registered" or "Waitlisted - Pending". When Attendee's Registration Status is updated to "Registered" the Registration Date/Time is set.

    • Step 7: The ERS record is processed.
    • Step 8: Authorized Transactions are captured.
    • Step 9: A Transaction receipt is sent to the donor if that's enabled as a Workflow Rule.
    • Step 10: The Contact/Lead is attempted to be matched on configured Salesforce matching and duplicate logic. If a match, the rest of the logic follows under that Contact/Lead. If there's no match, a new Contact/Lead is created. Default matching logic: First Name, Last Name, and Email.

    • Step 11: The Payment Method and Transaction from Steps 2 and 3 are updated to this new Contact (if the Contact has been created).
    • Step 12: An Invoice is created and all Attendees and the Contact (Bill To) or Lead (Bill To) are related.

Free Event Checkout Process

The process your Attendees will follow when viewing and registering for your free Event.

Paid Event Checkout Process

The process your Attendees will follow when viewing and registering for your paid Event.

Checkout from an AttendeeLink

If an Attendee starts the checkout process via an AttendeeLink, but the Event Item field on the Attendee record is left blank, the following checkout process will now occur.

  1. An Attendee clicks their AttendeeLink to start the checkout process.
  2. The Attendee does not see the Capacity Selector for the Event Item. They only see the Redeem Item button next to the Event Item.
  3. Once the Attendee clicks the Redeem Item button, the selected Event Item will be added to the cart, and the Capacity Selector will be visible.
  4. The Attendee will now be able to complete the checkout process.

ERD Entity Relationship Diagram

D_06_Entity Relationship Diagram


  • Event: Overall wrapper that just about everything relates to!
  • Attendee: Junction between Event, Contact, and Lead.
  • Event Item Purchase: Enables multiple quantities of a single Line Item to relate to multiple Attendees. Junction between Line Item and Attendee.
  • Line Item: Represents the ticket or item purchased from the Event checkout.
  • Invoice: The Order that represents each Line Item purchased. Relates to the Event, Account, and Contact.
  • Event Item: The item being purchased. Can relate to a Product and Price Book but does not need to. The Line Item references the Event Item.

Failed Event Registrations:
An email alert will notify the authorized user when any registrations fail, so they can quickly manage the issue. The workflow rule is called "Blackthorn | Events ERS Failed", which is enabled by default and uses the email template "Blackthorn | Events ERS Failed".
D_06_Failed Registration

Guidelines for Adding Logic Post Attendee Creation

Add an after insert/update trigger since the Contact/Lead are mapped on Attendee by Blackthorn using before insert/update logic.
Encapsulate your logic in a try-catch block. If anything fails in your trigger, it will cause the whole ERS process to fail.