Payflow Pro

You must apply for a merchant bank account. The merchant bank is where all the credit card transactions are verified. You can find a list of financial institutions using the authorization gateway website. However, before contacting a merchant bank, check with your bank to see if it is compatible with the authorization gateway.

Every organization accepting online credit card transactions must have a merchant account with an acquiring financial institution.

The acquiring financial institution deposits the daily credit card sales into the merchant’s account after deducting applicable fees. Some acquiring financial institutions perform merchant services in-house; others outsource these functions to a third-party processor. These services may include billing, customer service, reporting, authorization, and settlement services for merchants. A third-party processor is a company that provides credit card services to merchants on behalf of acquiring financial institutions.

You must set up an account with PayPal (previously VeriSign) for your Payflow Pro card authorization gateway. Set up your account by going to the PayPal website.

Make a note of your user login and password. You will need your user login and password to configure iMIS, and to view reports on the PayPal website. ASI Technical Support does not have access to this information.

When setting up an account for a non-US currency, you might encounter errors while testing a transaction. In that case, create a support ticket.

When opening an Australian Dollar account, go here.

Enter gateway information. Do the following to add a payment gateway:

📘 Note

For the Vantiv/WorldPay gateway, some of the following configuration items are addressed in the ASI-hosted DataVault and are not applicable. These configuration items are managed by ASI.

1. From the Staff site, go to Settings > Finance > Gateway accounts.

📘 Note

For access to this navigation item, system administrators must have an authorization level of AR/Cash: 5 -  Table Maintenance.

2. Select Add new gateway account and select a payment gateway from the Gateway drop-down. Once you save a card authorization account, you cannot change the Gateway field.

📘 Note

The Vantiv/WorldPay gateway will only be available for selection in this drop-down if you have a Vantiv/WorldPay license.

3. Enter an Account code. This value cannot be changed once the record is saved and cannot include spaces.

📘 Note

When entering gateway information for Payflow Pro, SecurePay, iATS or Vantiv/WorldPay, your Account code is already predefined. If you want to modify the Account code it must match the entry in the web.config file:

-For Desktop-based Payflow Pro transactions, enter VERISIGN.

-For SecurePay, enter SECUREPAY.

-For iATS, enter IATS.

-For Vantiv/WorldPay, enter VANTIV.

-For AutoPay-enabled Payflow Pro transactions, enter DVPAYFLOWPRO.

If you are not self-hosted, you must contact your host for assistance modifying web.config files.

The Account code is used to identify which gateway settings should be synchronized with and used by the tokenization engine. This identification happens in the iMIS web.config file (go to C:\AsiPlatform\Asi.Scheduler_[your instance]\web.config). The following Account Codes are available out-of-the-box:

• VANTIV
• SECUREPAY
• IATS
• VERISIGN
• DVPAYFLOWPRO

If you want to use a different Account code, make sure to update the web.config file. The account codes listed in the authorizationAccounts list for DataVaultPaymentGatewayProvider in the web.config file use the tokenization engine for payment processing.

<paymentGatewayService>
  <providers>
    <add name="PayFlowProPaymentGatewayProvider" type="Asi.PaymentGateway.PayflowProPaymentGatewayProvider, PayflowProPaymentGatewayProvider" authorizationAccounts="VERISIGN,PaymentTech,PAYFLOWPRO" />
    <add name="NoProcessingPaymentGatewayProvider" type="Asi.PaymentGateway.NoProcessingPaymentGatewayProvider, NoProcessingPaymentGatewayProvider" authorizationAccounts="NOPROCESS,DEBIT" />
    <add name="PayPalPaymentGatewayProvider" type="Asi.PaymentGateway.PayPalPaymentGatewayProvider, PayPalPaymentGatewayProvider" authorizationAccounts="PAYPALEC" />
    <add name="MonerisPaymentGatewayProvider" type="Asi.PaymentGateway.MonerisPaymentGatewayProvider, MonerisPaymentGatewayProvider" authorizationAccounts="MONERIS" />
    <add name="TnsPayPaymentGatewayProvider" type="Asi.PaymentGateway.TnsPayPaymentGatewayProvider, TnsPayPaymentGatewayProvider" authorizationAccounts="TNSPAYAC,TNSPAYP" />
    <add name="DataVaultPaymentGatewayProvider" type="Asi.PaymentGateway.DataVaultPaymentGatewayProvider, DataVaultPaymentGatewayProvider" authorizationAccounts="DVPAYFLOWPRO,SECUREPAY,IATS,VANTIV" />
  </providers>
</paymentGatewayService>

4. Enter a meaningful description for the authorization account in the Description field. This information displays as read-only data on the CC Auth Account field on the Cash accounts setup page (in the Advanced Accounting Console, go to Finance > Options > Set up tables > Cash accounts).
5. (Not applicable for Vantiv/WorldPay gateways) Enter a Host Url. You will receive the Host Url from your gateway provider when you register.

   You can use test Host URLs while testing your gateway to verify setup. This ensures a real financial transaction is not mistakenly processed during the testing. Some common live and test Host URLs include:

   • Payflow Pro:
     • Host URL (Test) - pilot-payflowpro.paypal.com
     • Host URL (Live) - payflowpro.paypal.com
   • iATS:
     • North America - https://www.iatspayments.com
     • United Kingdom - https://www.uk.iatspayments.com

     📘 Note

     For any countries outside North America, the United Kingdom URL must be used.

   📘 Note

   The Host Url is required for the iATS gateway. For more information about Live or Test accounts on the iATS gateway, contact iATS.

   • SecurePay:
     • Credit card transactions:
       • Host URL (Test) - https://test.securepay.com.au/xmlapi/payment
       • Host URL (Live) - https://api.securepay.com.au/xmlapi/payment
     • Direct debit transactions:
       • Host URL (Test) - https://test.securepay.com.au/xmlapi/directentry
       • Host URL (Live) - https://api.securepay.com.au/xmlapi/directentry

   📘 Note

   The Host Url is required for the SecurePay gateway. For more information about Live or Test accounts on the SecurePay gateway, contact SecurePay. 

   • Moneris
     • Host URL (Test) - esqa.moneris.com
     • Host URL (Live) - www3.moneris.com
   • TNSPay (Test) - secure.na.tnspayments.com

   📘 Note

   For the most up-to-date live and test Host Url information, contact your gateway provider or refer to your gateway provider's documentation.

6. (Vantiv/WorldPay gateway only) Enter your Merchant ID in the Vendor field.
7. (PayflowPro gateway only) Enter your Username in the Vendor field.
8. (Not applicable for Vantiv/WorldPay gateways) Enter a Username (this is the user name supplied by the gateway):
• For SecurePay, enter the Merchant ID in this field.
• For iATS, enter the Agent value in this field.
9. (Not applicable for Vantiv/WorldPay gateways) Enter the Password you were given by the gateway provider during the sign-up process. Verify your password.

For Moneris gateways, enter the API token (password) you were provided by Moneris.

📘 Note

Moneris requires clients using the API key to have their AVS turned on.

10. Click Save.
11. From the Advanced Accounting Console, reset IIS.
12. Recycle the AsiSchedulerPool:

    📘 Note

    If you are not self-hosted, you must contact your host for assistance recycling the AsiSchedulerPool.

    1. Open the IIS administrative utility. Go to Start > Administrative Tools > Internet Information Services (IIS) Manager.
    2. In the left navigation panel, go to Sites > Default Web Site.
    3. Select Content View at the bottom of the screen.
    4. Select the Asi.Scheduler_ [your instance] application for the instance you installed.
    5. Do one of the following:
       • Right-click and select Manage Application > Browse. An ASP.Net page will open.
       • In the Actions pane, select Browse. An ASP.Net page will open.
    6. Close the browser. The Asi.Scheduler_ [your instance] service is now enabled.
13. For iATS, SecurePay and Vantiv/WorldPay gateways, you must synchronize your payment gateway with the DataVault. Simply adding and saving a payment gateway in iMIS will not synchronize this information with the tokenization engine.

🚧 Warning

You must define the DataVault Service address before you attempt to synchronize your payment gateway with the DataVault. If you do not have this address defined, iMIS will be unable to communicate with the DataVault and the synchronization attempt will fail. For more information, see DataVault service address.

Do the following:

1. From the Staff site, go to Settings > Finance > Automatic payment gateways.
2. Click Synchronize gateways with DataVault to synchronize the gateways you defined and saved in iMIS with the ASI-hosted tokenization engine.

Before you can use card authorization, you must set up cash accounts:

1. From the Staff site, go to Settings > Finance > Cash accounts.
2. Select Add new cash account.
3. In the Code field, enter the abbreviation you want to assign to the cash account you are creating.

You can use any code you prefer for a credit card, debit card or direct debit:

For a credit card number to be validated by iMIS, the value, in addition to being a cash account of type Credit Card, must contain one of the credit card types iMIS supports:

• AMEX
• VISA
• MC
• DISC
• DINERS
• CB

For a direct debit, the first two letters control the country for the direct debit, for example:

• CA = Canada
• US = United States
• AU = Australia

Make sure the correct payment gateway is linked to the appropriate cash account: iATS or Vantiv/WorldPay can be used for Canadian direct debits, SecurePay is used for Australian direct debits, and Payflow or Vantiv/WorldPay can be used for US direct debits. The default Code prefix is US. The prefix determines the region-specific information needed for your payment methods. It is advised that you use the default Code as other countries might be supported in the future.

4. In the Name field, enter the full name you want to assign to the account.
5. Select a Type:
   • Cash - Specifies that the account is a checking or other deposit account (other than a credit card account).
   • Credit card - Specifies that the account is a credit card account.
     • US debit cards and credit cards are handled the same in iMIS.
   • Other - Specifies that the account is a non-cash asset account.
   • Debit card - Specifies that the account is a European debit card account.
   • Service – Specifies that the account is a third-party payment service, such as PayPal Express.
   • Direct debit - Specifies that the account is a direct debit account (payment is taken directly from the bank account) that is used with automatic and recurring payments.
6. (optional) From the Account drop-down, select the cash account.
7. (optional) Select the Entity. For more information, refer to Financial entities.
8. (Credit card, Debit card, Direct debit, and Service only) Select the associated Gateway account.
9. (optional) Depending on the Type and Gateway account chosen, the following checkboxes appear:
   • CSC Required for web transactions - Makes the CSC required for the specified cash account when on the web.
   • CSC Required for desktop transactions - Makes the CSC required for the specified cash account in the AAC/Desktop.

   📘 Note

   See Requiring a CSC for credit card or debit card transactions for more information.

   • Display issue number - Displays a field for entering a European debit card's issue number in payment entry windows. When cleared, the Issue Number field is not displayed in payment entry windows.
   • Display issue date - Displays a field for entering a European debit card's issue date in payment entry windows. When cleared, the Issue Date field is not displayed in payment entry windows.
10. Click Save.

PayPal transaction entries are generated with a captured status. You can edit or delete payment transactions if the changes are made on the same day. If the transaction has already been charged to the credit card, an error will be reported.

iMIS assumes that authorizations are captured every night, so the changes are only allowed if performed on the same system date as the authorization. However, the system date might not be the same as the batch date or the transaction date.

📘 Note

Deferred payments have not been authorized and can be edited without restriction.