Appearance

Portal Manager User Manual: Adding Payment Connectors and Webhook URLs ​

This guide walks portal managers through adding payment connectors and configuring webhook callback URLs for OTC (Over-the-Counter) payments like 7Connect OTC.

1. Overview ​

Portal managers can connect merchants to payment processors via Payment Connectors. Each connector has a public webhook callback URL that must be set in the payment processor’s system. This allows PayConnect to receive and load payment transactions.

2. Adding a Payment Connector ​

  1. Go to Merchant Management in the portal.

  2. Select a merchant.

  3. Open the Payment Connectors tab.

  4. Click Add Connector.

  5. Fill out the following fields:

    • Connector Public ID – unique ID (from processor or generated).
    • Processor Merchant Public ID – from the payment processor.
    • Processor Secret API Key – from the payment processor.
    • Payment Processor – select 7Connect OTC or other.

  6. Click Save.

3. Webhook Callback URLs ​

Once a connector is added, a webhook URL is generated per environment. This URL must be configured in the payment processor's dashboard to enable transaction updates.

Webhook URL Format ​

EnvironmentCallback URL
devhttp://dev-checkout-api.payconnect.io/Callbacks/SevenConnectOtc/{connectorPublicId}
testhttp://test-checkout-api.payconnect.io/Callbacks/SevenConnectOtc/{connectorPublicId}
sbxhttp://sbx-checkout-api.payconnect.io/Callbacks/SevenConnectOtc/{connectorPublicId}
prodhttp://checkout-api.payconnect.io/Callbacks/SevenConnectOtc/{connectorPublicId}

Replace {connectorPublicId} with your actual connector's public ID.

Example (dev): ​

http://dev-checkout-api.payconnect.io/Callbacks/SevenConnectOtc/public-key-123

Steps to Set Up in Payment Processor: ​

  1. Log in to the external payment processor dashboard (e.g., 7-Eleven/GCash).
  2. Locate the webhook/callback URL setting.
  3. Copy the correct URL for your environment from the table above.
  4. Paste and save the URL in the processor’s dashboard.

Important: Do not set this URL in the PayConnect portal. It must be set in the external payment processor’s system so they can notify PayConnect of payment events.

4. Managing Connectors ​

  • View/edit/remove connectors under the merchant’s Payment Connectors section.
  • After creating a connector, URLs for each environment will be shown.

5. Reminders ​

  • 🌐 The webhook callback URL is required for payment updates.
  • 🔐 Keep public and secret keys secure.
  • 📎 Use the correct environment-specific URL.

See Also ​