Setup Integrations API
API Integrations are configured to allow ConnexCS to connect to external services. For inbound APIs, please see the API in the Architecture documentation.
- PayPal Express Checkout - Allows online checkout via the customer portal using a PayPal Account.
- PayPal IPN - For customers who wish to use a PayPal feature called MassPay, or want send money from the PayPal portal without using your site, IPN can be enabled. This notifies the system of incoming PayPal payments and we can top-up based on that notification. See PayPal IPN Integration below for specific details and setup.
- Stripe - Possibly the world's best credit card processor, Stripe can be made available on your customer portal.
- Duo Security - With Duo Security we can provide 2FA (2 Factor Authentication) via an out-of-band push notification to your mobile device when you sign in. This can then be approved and also benefit from fingerprint authentication.
- Moneris - A Canadian Credit Card Processing service, Moneris can be made available on your customer portal.
- Razor Pay - Razor Pay is a large payment processor from India.
Enable API Integration¶
- Click the
Select the desired service from the drop-list.
Select the Mode (PayPal Express, Stripe, ScriptForge, Razor Pay only):
- Test for testing connections
- Live for an active account
- Complete the dialog box and press the
API Service details
Each service requires different details. These can be obtained using your account with the specific provider(s).
PayPal IPN Integration¶
PayPal's Instant Payment Notification (IPN) is a service that provides notifications for PayPal transactions. IPN messages can be used to automate bulk payment processes, where consumers still send PayPal payments as normal. Payments made using this integration will automatically top-up the customer account in ConnexCS. For this to work, settings need to be configured on the ConnexCS control panel as well as PayPal.
Mass Payment is a bulk payment method that sends funds in an uploaded file to PayPal, allowing the sender to pay less than the standard PayPal fees using their bulk order discounts. Since this payment doesn't trigger anything our VoIP system, we link into PayPal's IPN to accommodate notifications and balance sheet updates.
Mass Pay vs Express Checkout
Use this comparison chart listing the differences between Mass Pay and Express Checkout with PayPal to help you decide which to use:
|Mass Pay||Express Checkout|
|A CSV is uploaded to PayPal's website.||Made through customer portal.|
|Slightly lower transaction fees.||Standard PayPal fees (about 3.4% + $0.30).|
|Fees are paid by the sender.||Fees are paid by the recipient.|
|Sender pays a 2% transaction fee, capped at $1 per payment.||Recipient pays by per-transaction deductions.|
|Uses PayPal IPN.||Uses PayPal API Signature.|
Integrate PayPal IPN¶
Below are the steps to configure IPN:
Step 1: Configure ConnexCS
- Select PayPal IPN and update the following:
- IPN URL: This should never be modified, you will need it later to complete the integration.
- Payment Type: Select "Mass Pay" (described above) or "Send Money" (fees may apply).
- Verify Transaction: ConnexCS will check with PayPal to make sure the transaction is correct
- Currency: Select one or more currencies that you will accept.
- Deduct Payment Fees: Set whether you will deduct the fees or not.
- To find the IPN URL (needed later in configuration), open the
paypal_ipnnow listed in API.
Step 2: Identify your IPN listener to PayPal
After you have configured ConnexCS, add it to your PayPal account. (Copied from PayPal instructions here.)
- Login to a PayPal Business Account (A PayPal Business Account--not to be confused with a regular PayPal account--is required to perform this task.)
- Navigate to Settings > Account Settings > Notifications
- Select Update next to Instant payment notifications.
- Click Choose IPN Settings.
- Enter the IPN URL under Notification URL and select Receive IPN Messages (Enabled) click Save.
- Fill in the settings, and then copy the API URL.
Step 3: Insert credentials in your ConnexCS Account
Enter the new credentials back into your account. (PayPal steps copied from PayPal instructions here.)
- Navigate to Setup Integrations API
- Select Add PayPal.
- Select the Mode: Test for testing connections or Live for an active account
- In your PayPal account, navigate to Settings Account Settings Account Access.
- Click the
Updatebutton for API Access.
- Select Manage API Credentials under NVP/SOAP API integration (Classic) section.
- Select Request API signature, then
Agree and Submit.
Copy the API Username, API Password, and Signature credentials from this page into the open PayPal form in ConnexCS.
Add customer PayPal Email address to ConnexCS customer account¶
The following are instructions on how to add a PayPal Email address to a ConnexCS customer account:
- Navigate to Management Customer [Customer name]
- Enter the customer's Name and PayPal email address and click
- From the customer's main page, select Edit Config.
- Enter the customer PayPal email ID and click
View PayPal IPN Payment Log¶
These payments can be viewed under Setup > Information > Payment Log.