Laserfiche Process Automation to Payflow Pro Setup Guide

Payflow Pro for Laserfiche Workflow Configuration Guide

Velosimo Configuration

  1. Go to and login with your email address
  2. Using the Velosimo menu, navigate to Data -> Objects
  1. Under the Objects go to the Payment -> Settings datatype
  1. The Settings datatype contains three entries to configure for your environment. For each entry go to the right row menu and go to Edit.

a. Editing the PAYFLOW_PRO_INFO settings:

partnerPaypal partner name. This is the same partner named as used to login to the Paypal Manager.
vendorPaypal vendor name. This is the same vendor name as used to login to the Paypal Manager.
userPaypal user. This is the same user name as used to login to the Paypal Manager.
passwordPaypal user password. This is the same password as used to login to the Paypal Manager. Password cannot contain special characters or it will not work (Paypal limitation).
modeTEST or LIVE
urlLeave set to

b. Editing the LASERFICHE_WORKFLOW_INFO settings:

onPaymentReceiveThe name of the Laserfiche Workflow to call when the payment is completed. The workflow will be sent the following parameters:


c. Editing the PAYMENT_EMAIL settings:

subjectThe subject of the payment email sent
  1. Next, navigate to Gateway -> Connectors.
  1. Under Connectors go to Connections and Edit the Laserfiche Workflow connection.
  1. Change the Url value to the URL of your Laserfiche Workflow API. Your Laserfiche Workflow API must be accessible to the Velosimo Cloud environment. All requests from Velosimo will come from the following IPs,, Click Save when finished editing the URL.
  1. Next click the checkmark icon on the top menu to access the Authorizations and go to Authorize on the Laserfiche Workflow authorization.
  1. Enter the username and password of the Laserfiche Workflow user to use for authentication to Laserfiche Workflow and click Save.
  1. Next go to Workflows -> Email Channels using the Velosimo menu
  1. Under Email Channels select SMTP Account and then go to Edit
  1. Next click the Edit this SMTP Provider button
  1. Change the Host, Port, and Domain (optional) to your SMTP server information. All requests from Velosimo will come from the following IPs,, Click Save once finished.
  1. Next set the Username and Password fields to the email user you wish to use for sending emails against your SMTP server. You can optionally configure the Send email as field to better style the emails From field. Once complete click Save.

Styling the Payment email

  1. Navigate to Transforms -> Templates
  1. Edit the Payment Email Body template by going to Edit on the right menu
  1. The Payment Email Body template is an ERB template, which is essentially HTML with some scripting capabilities using Ruby. To update the style of the email simple edit the HTML within the Code section and click Save once complete.
  1. The template will support any HTML and is currently using Semantic UI. See for more information on Semantic.

The template will support variable data sent from Laserfiche Workflow. You have full control over the template data sent from Laserfiche Workflow by using <%=data[“”]%> within the HTML. laserficheWorkflowAPIParameterName will map to the name of the input parameter sent to Velosimo from your Laserfiche Workflow. The Laserfiche Workflow configuration section will cover this in more detail.


Payflow Pro Configuration

  1. Go to and login with your credentials
  2. On the main page go to Hosted Checkout Pages
  1. Next click setup
  1. On the Set Up page configure the options you would like enabled and enter the correct Velosimo URLs into the fields from the table flow.

<payment_app_name>: Application regist name
<security_token>: Application ID

Cancel URL<payment_app_name>/laserfiche/payflowpro/<security_token>/cancel_payment?X-Tenant-Access-Key=A459798590&X-Tenant-Access-Token=G1wycC97U4W1B2qXqSDS
Error URL<payment_app_name>/laserfiche/payflowpro/<security_token>/payment_error?X-Tenant-Access-Key=A459798590&X-Tenant-Access-Token=G1wycC97U4W1B2qXqSDS
Return URL<payment_app_name>/accela/payflowpro/<security_token>/payment_confirmation?X-Tenant-Access-Key=A459798590&X-Tenant-Access-Token=G1wycC97U4W1B2qXqSDS
Silent Post URL<payment_app_name>/laserfiche/payflowpro/<security_token>/process_payment?X-Tenant-Access-Key=A459798590&X-Tenant-Access-Token=G1wycC97U4W1B2qXqSDS

Check the checkbox for ‘Void transaction when my server fails to receive data sent by the silent post’
Silent Post fails<payment_app_name>/laserfiche/payflowpro/<security_token>/process_payment?X-Tenant-Access-Key=A459798590&X-Tenant-Access-Token=G1wycC97U4W1B2qXqSDS
  1. Click Save

Laserfiche Workflow Configuration

Sending a Payment

  1. To send a payment from a Laserfiche Workflow you will use the HTTP Form Post component. In the workflow you wish to send payment from, add the HTTP Form Post component to the workflow and then go to the Web Services configuration of the HTTP Form Post.
  1. Configure the HTTP Form Post with the following information:
    a. Web Service - select Manage Web Services from the dropdown list and add a new entry for Velosimo.
        b. Request - Enter the request information

Remember, the <security_token> is the Application ID.

        c. Form Data - map any data into the variables sent to Velosimo
referenceIdUnique id for this transaction. Can be any value you want to generate. The referenceId sent here will come back in the Receive Payment workflow. You can use the referenceId to tie the receive payment to the send payment.
amountAmount to charge
emailEmail address of the receiving user
The next set of variables are used in the Payment Email Body template in Velosimo and are customizable. You can send any variables you would like to send here and use in the email body template. The fields below are used in the default template, but can easily be customized by you.
fullNameName of the receiver. Variable is used in the Payment Email Body template in Velosimo.
applicationType of application. Variable is used in the Payment Email Body template in Velosimo.
dueDateDue date of the payment. Variable is used in the Payment Email Body template in Velosimo
  1. Run the workflow to test and a payment email will be sent to the email address

Receiving a Payment

  1. As soon as a successful payment is made in Payflow Pro a call will be made to a receiving Laserfiche Workflow per the Velosimo configuration. The workflow will be sent with three parameters.
referenceIdId sent during the send payment process
transactionIdPaypal Payflow Pro transaction id. You can use this value to lookup the transaction in Payflow Pro Manager.
transactionStatusStatus of the transaction as sent by Payflow Pro
  1. Should you wish to use more information from the transaction in your workflow than sent you can make an HTTP Form Post call from within your workflow to a Velosimo API to get more detail about the transaction. To get more detail configure an HTTP Form Post as follows:

        a. Request
        b. Form Data
referenceIdId for this transaction
  1. The Response from the HTTP Post will be a JSON object that looks as follows:
      "email":"[email protected]",
      "fullName":"Kris Trujillo",
      "application":"Garage Sale Permit",
      "dueDate":"March 1, 2022",
      "BILLTOEMAIL":"[email protected]",
      "BILLTOSTREET":"12537 S Brundisi Way",
      "NAMETOSHIP":"Kris Trujillo",
      "EMAILTOSHIP":"[email protected]",
      "NAME":"Kris Trujillo",
      "SHIPTOSTREET":"12537 S Brundisi Way",
      "POSTFPSMSG":"No Rules Triggered",
      "EMAIL":"[email protected]",
      "PREFPSMSG":"No Rules Triggered",
      "ADDRESS":"12537 S Brundisi Way",
      "BILLTONAME":"Kris Trujillo",
      "ADDRESSTOSHIP":"12537 S Brundisi Way",
      "TRANSTIME":"2022-03-15 15:06:16",
      "type":"Credit Card",
      "payee":"Kris Trujillo",
      "payeeAddress":"12537 S Brundisi Way"

Laserfiche Forms Configuration

  1. Go to
  2. Go to Design and select your form
  3. Open the details on the form diagram
  1. Select Start and the On Event Completion tab
  1. There are two options with what to do after submitting the form:
    a. Show a follow up message - Customize an email to be sent after submitting the form
        b. Redirect to website - Enter a URL to redirect to once the form is submitted