Pre install considerations
By default, on first install from the Appexchange you will be granted a 90 day trial. You will be able to process test payments during this period. After the trial period you will be required to sign up to a yearly subscription. Please contact us for a detailed quote / contract.
Upgrade an existing package
Asperato is a managed package, and can thus be upgraded the same way you would install any other package. Simply paste the link into the browser while logged into the Salesforce org, and follow the upgrade instructions.
Supported Salesforce versions, Lightning vs Classic
The Asperato package can be used in both Lightning and Classic mode, the functionality is identical. The only exception is that initial ‘Setup’ needs to be completed in Lightning. The tabs are the same, and the buttons that appear as lightning quick actions in lightning experience will appear as standard Salesforce buttons in Salesforce Classic.
If you're using Asperato in Lightning experience, we provide paths on our objects to give you a visual display of the payment or authorisation status. If you wish to use these paths, you'll need to follow the instructions here to enable paths.
Installing the package
Asperato ONE is installed from the Salesforce Appexchange. After installation, head to the "Asperato Setup" tab and follow the on-screen instructions to complete the installation.
Please note you must be in Lightning to complete this setup and have My Domain configured.
Connect Salesforce to Asperato
Asperato is a Connected App. To securely connect Salesforce to Asperato:
- Ensure you are in lightning experience, not classic
- Navigate to the Asperato ONE app
- Click on the "Asperato Setup tab"
- Click the "Setup configuration" button
If you've completed the above successfully, you should see something like the following:
Connecting Salesforce to your chosen Payment Service Providers
On the Asperato Setup page you will see a list of pre-connected payment service providers. These allow you to take immediate test payments. If you wish to connect your own payment service provider, please see the instructions here.
Create your first payment request
We're assuming you're connected to Stripe as a test gateway, which is the default on installing the package. If you've connected to another gateway instead, please see their documentation for appropriate test card details.
Try out the connection and take a simple, one-off card payment:
- Navigate to the "Payments" tab
- Create a new Payment record:
- For "Amount", select 10
- For "Payment route", select card
- When the payment record has been created, click the "Process payment button".
- Fill in the form that appears using the following details:
- Card number:
- Expiry date:
- Card number:
Note that you should never use real card details in a test payment form. Doing so is insecure, and means you could be breaking PCI compliance regulations.
Refresh the Salesforce payment record once complete to see the payment record completed. Congratulations - you've taken your first test payment!
You probably won't want all your Salesforce users to have permission to take payments. Asperato ONE ships with 3 permission sets that you can apply to relevant users in your org:
- Asperato standard user - A user with this permission can setup payments, authorisations and payment schedules.
- Asperato refund user - In addition to the above, this permission allows a user to issue refunds.
- Asperato full admin - In addition to the above, this permission set provides access to all setup and administration features in the package.