Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Congratulations on installing PosiPay! After your initial installation, you are now able to configure the features to make them accessible.

Note: Do this after installing the latest package.

Grant Access to PosiPay

To have access to the PosiPay features, assign PosiPay’s Permission Set to a User with a System Administrator profile.

...

For Stripe to be able to engage with PosiPay, we need to create the right environment that allows Stripe to speak to certain objects within PosiPay.

Enable Communities

Enable the Experience Cloud communities.
Setup > Digital Experiences > Settings > tick Enable Digital Experiences > click Save

...

Create Community Site

Create a site for Webhook

  • Go to Setup > All Sites > Click New

...

  • Choose a template, for our Site, we > choose Build Your Own (Aura) .

...

  • Fill in the necessary information then click Create.

For example:

...

  • After doing so, click Builder.

...

  • Display the Stripe Form component.

  • Fill out the following fields below:

    • Required Fields

      • Gateway Account = Gateway ID

      • Payment Method = Credit Card; Direct Debit

      • Require CVC = TRUE

...

  • Click the Publish button in the upper right corner and it will show a confirmation message and click Publish.

...

After creating the Community Sites do the following configuration:

  1. Go to Setup > Home page

  2. In the Quick Find box search All Sites and click Builder

...

  1. The Community page should be accessible by Guest User

...

  • > click Builder

  • Fill out the Name and URL

    • Name = Webhook

    • URL = webhook

      image-20240624-233806.pngImage Added
  • Publish the site by clicking the Publish button.

    image-20240925-023045.pngImage Added

  • Set the site to Public Access.

...

Webhook Guest User Profile Config

Enable Webhook Listener

In the next step, we will set up the webhooks from Stripe’s end, but first, you need to make sure you are configured to be able to listen to them correctly.

...

  • Enabled these Apex Classes

    • PosiPay.CommonFunction

    • PosiPay.StripeFormComponentController

    • PosiPay.WebhookListener

...

Webhook Object Access

Go to Setup > Click All Sites

...

  • Search for the Objects that you want to configure for the Guest User.

...

  • Gateway Event
    Click Edit and tick Read and Create under the Object Permissions as well as in Fields Permissions and click Save.

    image-20240312-080253.png

    image-20240312-080327.png

  • Gateway Account

    image-20240131-031029.pngimage-20240527-000233.png

  • PosiPay Log

    image-20240131-031121.png
  • Gateway Invoice

...

Create a Community Site for Stripe Form

  • Go to Setup > All Sites > Click New

...

  • Choose a template, for our Site, we choose Build Your Own (Aura).

...

  • Fill in the necessary information then click Create.

...

  • After doing so, click Builder.

...

  • Display the Stripe Form component.

  • Fill out the following fields below:

...

  • Click the Publish button in the upper right corner and it will show a confirmation message and click Publish.

...

After creating the Community Sites do the following configuration:

  1. Go to Setup > Home page

  2. In the Quick Find box search All Sites and click Builder

...

  1. The Community page should be accessible by Guest User

...

Manually Displaying Fields in Page Layout

...

Display the following fields in the page layout.

  • Payment Status

  • Check Date 

  • Check Drawer 

  • Payment Identifier 

  • Payment Method 

  • Receiving Bank Account 

  • Status 

...

Go to Set up > Search for Picklist Value Set > Payment Method

...

Set up the Smart Retries on a Stripe account

There are various reasons why payments may fail, but many of them are fixable. If you are using Stripe Billing you can use Stripe to automatically retry failed payments by configuring the settings in the Retries tab of the Revenue Recovery Dashboard.

Open your Stripe Account and then locate and click on the “Revenue Recovery” option in the navigation menu.

...

...

Sharing Settings

Enabling the guest user to obtain access to the gateway account and gateway events Gateway Account and Gateway Events records.

  • Go to Set up

  • In the Quick Find box search for Sharing Settings

...

  • Under the Sharing Rule section, look for Gateway Account Sharing Rules and

...

  • Gateway Event Sharing Rules then click New.

...

Gateway Account and Gateway Event Sharing Rule

Note: The same process will be set up in Gateway Account and Gateway Event.

...

Step 3: Select which records to be shared

  • Field: Owner ID

  • Operator: equalsnot equal to

  • Value: Guest User ID

...

Step 4: Select the users to share with

...

  • Access Level: Read Only

...

  1. Click Save.

Change Data Capture

Go to Set Up and search for Data Capture.
In the Change Data Capture search for Gateway Transaction (PosiPay__GatewayTransaction__c) and Bank Statement Line (PosiPay__BankStatementLine__c) . Add it as Selected Entities then click Save.

...

Translation Workbench

Enable Translation Workbench

...

View file
nameposipay_en_AU_translation (1).stf

Export STF File

Note: Do this step if you (the translator) don’t have an STF file; otherwise, if you do, then skip this step.

If you are a translator or if you don’t have a STF file yet for importing. You can export it and translate the words that are translatable for your org’s supported language.

...