Laserfiche Process Automation to Payflow Pro Setup Guide

Payflow Pro for Laserfiche Workflow Configuration Guide

Velosimo Configuration

1. Go to https://connect.velosimo.io and login with your email address
2. Using the Velosimo menu, navigate to Data -> Objects

3. Under the Objects go to the Payment -> Settings datatype

4. 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:

b. Editing the LASERFICHE_WORKFLOW_INFO settings:

c. Editing the PAYMENT_EMAIL settings:

5. Next, navigate to Gateway -> Connectors.

6. Under Connectors go to Connections and Edit the Laserfiche Workflow connection.

7. 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 54.70.20.215, 35.164.131.175, 3.222.241.24. Click Save when finished editing the URL.

8. Next click the checkmark icon on the top menu to access the Authorizations and go to Authorize on the Laserfiche Workflow authorization.

9. Enter the username and password of the Laserfiche Workflow user to use for authentication to Laserfiche Workflow and click Save.

10. Next go to Workflows -> Email Channels using the Velosimo menu

11. Under Email Channels select SMTP Account and then go to Edit

12. Next click the Edit this SMTP Provider button

13. Change the Host, Port, and Domain (optional) to your SMTP server information. All requests from Velosimo will come from the following IPs 54.70.20.215, 35.164.131.175, 3.222.241.24. Click Save once finished.

14. 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

2. Edit the Payment Email Body template by going to Edit on the right menu

3. 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.

4. The template will support any HTML and is currently using Semantic UI. See https://semantic-ui.com/ 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 https://manager.paypal.com and login with your credentials
2. On the main page go to Hosted Checkout Pages

3. Next click setup

4. 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

5. 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.

2. 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

3. 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.

2. 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

3. The Response from the HTTP Post will be a JSON object that looks as follows:

{
   "referenceId":"f23cf9ed1a684",
   "transactionStatus":"Approved",
   "transactionData":{
      "referenceId":"cd187f4a-e84b-45c4-871d-9c92f6a6bea0",
      "amount":"100.00",
      "user":"velosimo",
      "email":"kris@velosimo.com",
      "fullName":"Kris Trujillo",
      "application":"Garage Sale Permit",
      "dueDate":"March 1, 2022",
      "app_slug":"laserfiche",
      "path":"payflowpro/process_payment",
      "_source":"laserfiche",
      "_provider":"payflowpro",
      "_operation":"process_payment",
      "paymentLink":"https://connect.velosimo.io/app/scpaysupp/laserfiche/payflowpro/initialize_payment?amount=100.00\u0026referenceId=f23cf9ed1a684",
      "SECURETOKENID":"cd187f4a-e84b-45c4-871d-9c92f6a6bea0",
      "SECURETOKEN":"4tPE9SgyWVkqJyzYtsEhjrwAQ",
      "BILLTOCITY":"Herriman",
      "AMT":"100.00",
      "BILLTOEMAIL":"kris@velosimo.com",
      "BILLTOSTREET":"12537 S Brundisi Way",
      "VISACARDLEVEL":"12",
      "SHIPTOCITY":"Herriman",
      "TENDER":"CC",
      "NAMETOSHIP":"Kris Trujillo",
      "ZIP":"84096",
      "BILLTOLASTNAME":"Trujillo",
      "EMAILTOSHIP":"kris@velosimo.com",
      "BILLTOFIRSTNAME":"Kris",
      "RESPMSG":"Approved",
      "TYPE":"S",
      "STATETOSHIP":"UT",
      "TAX":"0.00",
      "NAME":"Kris Trujillo",
      "BILLTOZIP":"84096",
      "PNREF":"A10AB1D0E550",
      "ZIPTOSHIP":"84096",
      "TRXTYPE":"S",
      "SHIPTOCOUNTRY":"US",
      "SHIPTOSTREET":"12537 S Brundisi Way",
      "CITY":"Herriman",
      "HOSTCODE":"A",
      "LASTNAME":"Trujillo",
      "STATE":"UT",
      "CITYTOSHIP":"Herriman",
      "COUNTRYTOSHIP":"US",
      "AVSDATA":"YNY",
      "ACCT":"1111",
      "AUTHCODE":"850PNI",
      "PHONE":"8018793789",
      "FIRSTNAME":"Kris",
      "RESULT":"0",
      "POSTFPSMSG":"No Rules Triggered",
      "IAVS":"N",
      "BILLTOSTATE":"UT",
      "BILLTOCOUNTRY":"US",
      "EXPDATE":"0123",
      "BILLTOPHONE":"8018793789",
      "EMAIL":"kris@velosimo.com",
      "CARDTYPE":"0",
      "PREFPSMSG":"No Rules Triggered",
      "SHIPTOZIP":"84096",
      "PROCAVS":"A",
      "COUNTRY":"US",
      "AVSZIP":"N",
      "ADDRESS":"12537 S Brundisi Way",
      "BILLTONAME":"Kris Trujillo",
      "ADDRESSTOSHIP":"12537 S Brundisi Way",
      "AVSADDR":"Y",
      "SHIPTOSTATE":"UT",
      "METHOD":"CC",
      "TRANSTIME":"2022-03-15 15:06:16",
      "detailURL":"https://manager.paypal.com/getStandardDetails.do?subaction=transDetailsWithSB\u0026reportName=SettlementReport\u0026id=A10AB1D0E550",
      "type":"Credit Card",
      "payee":"Kris Trujillo",
      "payeeAddress":"12537 S Brundisi Way"
   },
   "transactionId":"A10AB1D0E550"
}

Laserfiche Forms Configuration

1. Go to laserfiche.velosimo.com
2. Go to Design and select your form
3. Open the details on the form diagram

4. Select Start and the On Event Completion tab

5. 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