Skip to content

Application Programming Interface Integrations

Setup Integrations API

Configure API Integrations to let ConnexCS connect to external services.

For inbound APIs, please see the API in the Architecture documentation.

Available Integrations

  • PayPal Express Checkout: Lets you do online checkout via the customer portal using a PayPal Account.

  • PayPal IPN: Enable Instant Payment Notification (IPN) to use MassPay or to send money from the PayPal portal without using your site.

    This also notifies the system of incoming PayPal payments, and we can top up based on that notification.

  • Stripe: Possibly the world's best credit card processor, Stripe; we can help with its availability on the portal.

  • Duo Security: Duo Security provides 2FA (2 Factor Authentication) via an out-of-band push notification to your mobile device to approve login.

    It also provides fingerprint authentication for extra security.

  • Moneris: Moneris is a Canadian Credit Card Processing service.

  • ScriptForge: ScriptForge is the ConnexCS JavaScript Sandbox environment, where you can write drivers to intermediate connectivity to a large variety of providers.

  • Razor Pay: Razor Pay is a large payment processor from India.

  • Xero: Utilising any domestic bank account, Xero Pay with Wise enables you to pay all your vendors through Xero and reconcile transactions.

  • Paystack: With the help of Paystack, you may take payments from clients using a variety of methods, including cards, mobile money accounts, QR codes, bank account direct deposits, and USSD.

  • PayMongo: With the help of PayMongo, your company can conveniently take payments from customers using credit cards, e-wallets, and over-the-counter transactions.

  • NOWPayments: With the support for auto coin conversion and the ability to take payments in over 75+ cryptocurrencies, NOWPayments is a non-custodial cryptocurrency payment gateway enabling users to accept payments in any coin they choose.

  • Emetec: Emetec provides Merchant services, Payments processing, eCommerce Payment Gateway, Real-Time-Payments, Online Transfers.

Enable API Integration

  1. Click Add.

  2. Select the required service from the list.

    alt text

  3. Complete the available fields (see individual API integrations below for details for each provider).

  4. Click Save.

API Service details

Each service requires different details.

You can find these using your account with the specific provider(s).

Compare PayPal Options

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 in 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 to decide between Mass Pay and Express Checkout with PayPal.

Mass Pay Express Checkout
PayPal's website receives an upload of a CSV (Comma-Separated Values) Made through customer portal
Slightly lower transaction fees Standard PayPal fees (about 3.4% + $0.30)
Sender pays the fee Recipient pays the fee
Sender pays a 2% transaction fee, capped at $1 per payment Recipient pays by per-transaction deductions
Uses PayPal IPN Uses PayPal API Signature

PayPal Express Checkout Integration

Enter your PayPal account information.

  1. Select Add and then select PayPal.
  2. Mode: Use Test for testing connections or Live for an active account.

  3. To find your Username, Password, and Signature:

    • Access your PayPal account and navigate to Settings Account Settings Account Access.
    • Click Update for API Access.
    • In NVP/SOAP API integration (Classic) section, select Manage API Credentials

    (NVP: Name-Value Pair, SOAP: Simple Object Access Protocol)

    • Select Request API signature, and then click Agree and Submit.
    • Copy the API Username, API Password, and Signature credentials from this page into the open PayPal form in ConnexCS.

    alt text

  4. Currency: Select one or more currencies that you will accept.

  5. Deduct Payment Fees: Set whether you will deduct the fees or not.
  6. Click Save.

PayPal IPN Integration

PayPal's Instant Payment Notification (IPN) is a service that provides notifications for PayPal transactions.

Automation of Bulk payment processes uses IPN messages, where consumers still send PayPal payments as usual.

Payments made using this integration will automatically top up the customer's account in ConnexCS.

For this to work, you need to configure the settings on the ConnexCS control panel and in PayPal.

Configure PayPal IPN

Steps to configure IPN:

Step 1: Configure ConnexCS

  1. Select Add, and then select PayPal IPN.
  2. Update the following:
    • IPN URL: You should never revise this; it's required later to complete the integration.
    • Payment Type: Select "Mass Pay" (described above) or "Send Money" (fees may apply).
    • Verify Transaction: If selected, 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.
  3. Click Save.
  4. To find the IPN URL (needed later in configuration), open the paypal_ipn now listed in API.

Step 2: Identify your IPN listener to PayPal

After you have configured ConnexCS, add it to your PayPal account (taken from PayPal support here).

  1. Login to a PayPal Business Account (must be a Business account, not a regular PayPal account).
  2. Navigate to Settings Account Settings Notifications.
  3. Select Update next to Instant payment notifications.
  4. Click Choose IPN Settings.
  5. Enter the IPN URL under Notification URL and select Receive IPN Messages (Enabled),and then click Save.
  6. Fill in the settings, and then copy the API URL.

Configure Customer with PayPal Email address

The following are instructions on how to add a PayPal Email address to a ConnexCS customer account:

  1. Navigate to Management Customer [Customer name].
  2. In Contacts, click .
  3. Enter the customer's Name and PayPal email address, and then click Save.
  4. From the customer's main page, select Edit Config.
  5. Enter the customer's PayPal email ID and click Save.

View PayPal IPN Payment Log

You can view these payments under Setup Information Payment Log.

Stripe Integration

Configure the Stripe API Keys in ConnexCS:

  1. Select Add, and then select Stripe.
  2. Mode: Use Test for testing connections or Live for an active account.
  3. Public Key (Publishable) and Private Key (Secret): Access the Stripe Dashboard (login if necessary) to access your keys (from Stripe Support; Test keys are also found in that link).
  4. Currencies: Select one or more currencies that you will accept.
  5. Surcharge: Amount charged for each transaction.
  6. Surcharge Precent:It's the percentage of the total charge that's added as an extra fee.

Duo Security Integration

Configure Duo Security Settings in ConnexCS:

  1. Select Add, and then select Duo Security.
  2. Integration Key, Secret, and Host: Access the Duo Admin Panel, locate the Auth API, click Protect (from Duo Auth support). Find the Integration Key, Secret Key, and API Hostname to complete setup in ConnexCS.
  3. AKey (Application Key): It's a secret key that's used to authenticate your application with Duo Security. You will need to provide the AKey to Duo Security when you configure your application to use Duo Security.

Moneris Integration

Link Moneris to ConnexCS:

  1. Select Add, and then select Moneris.
  2. Store ID: You can find this in the MRC Welcome emails (contact Moneris for help finding it).
  3. Signature: It's used to verify the identity of the cardholder to prevent frauds.

Scriptforge Integration

  1. Select Add, and then select Scriptforge.
  2. Company: Select the customer to integrate.
  3. Script Forge: Select the predefined script (details found under Developer Scriptforge.

Razor Pay Integration

Enter Razorpay settings into ConnexCS:

  1. Select Add, and then select Razorpay.
  2. Mode: Use Test for testing connections or Live for an active account.
  3. Key ID and Key Secret: Access the Razorpay Dashboard, go to Settings and Generate Test Key (from Razorpay support)
  4. Currency: Select one or more currencies that you will accept.
  5. Deduct Payment Fees: Set whether you will deduct the fees or not.

Xero Integration

Coming soon

Paystack Integration

Configure the Paystack Payment settings in ConnexCS:

  1. Select Add, and then select Paystack.
  2. Mode: Use Test for testing connections or Live for an active account.
  3. Public Key (Publishable) and Private Key (Secret): Access the Paystack Support Link to access the Test keys and Live keys.
  4. Currencies: Select one or more currencies that you will accept.

PayMongo Integration

Configure the PayMongo Payment settings in ConnexCS:

  1. Select Add, and then select PayMongo.
  2. Mode: Use Test for testing connections or Live for an active account.
  3. Public Key (Publishable) and Private Key (Secret): Access the PayMongo API Reference Guide to retrieve the Secret keys.
  4. Currencies: Select PHP (Philippine Peso) as the currency.

NOWPayments Integration

Configure the NOWPayments settings in ConnexCS:

  1. Select Add, and then select NOWPayments.
  2. Mode: Use Test for testing connections or Live for an active account.
  3. API Key: Access the NOWPAyments API Reference Guide to retrieve the Secret keys.
  4. IPN Key: Access the IPN Key guide.
  5. Currencies: You have several curriencies to choose from.

Emetec Integration

Configure the Emetec settings in ConnexCS:

  1. Select Add, and then select Emetec.
  2. Mode: Use Test for testing connections or Live for an active account.
  3. Entity ID: It's a unique identifier that's assigned to each entity in the Emtec system. The entity ID is a 12-digit alphanumeric string that's generated by Emtec. The entity ID isn't user-editable.
  4. Authorization: It;s a process of determining whether a user has permission to access a resource. In Emtec, authorization depends on roles and permissions.
  5. Currencies: Select USD as the currency.