The Developer Settings page centralizes tools and configurations for customizing your Mercoa integration. Whether you’re managing secure API access, setting up real‑time event notifications with webhooks, or tailoring the platform’s appearance and behavior, this area provides you with granular control over your integration environment.
The API Keys tab lets you manage the keys that authenticate your requests to the Mercoa API. You can manage your API keys for both test and live environments. Here you can also rotate API keys as needed, such as if access credentials are compromised.
This tab allows you to set up and manage webhooks, which are crucial for receiving real-time notifications about transaction events, invoice updates, or payment processing changes.
Endpoint configuration: Define the URL(s) where Mercoa should send webhook data.
Security settings: Configure unique tokens or secrets to ensure that incoming webhook notifications are authentically from Mercoa.
Event filtering: Select which types of events trigger a webhook, so you can focus on the notifications that matter most.
The Email Settings tab is dedicated to configuring the email notifications that Mercoa sends out. This includes when invoices are generated, processed, or require attention. Settings include:
Email provider configuration: Set up and authenticate your email service providers (such as Amazon SES, Cloudmailin, Resend, or Sendgrid).
Sender information: Define the “From” name and email address that appear on outgoing messages.
Incoming email domain: Configure the inbound email domains used for automated invoice processing, along with any alternative domains.
This tab lets you customize an embeddable iFrame, which can be used to integrate Mercoa’s core functionalities into your own website or application. Options include:
Customization options: Define which entities or user segments see the iFrame, set invoice status filters, and configure payment method settings that appear within the embedded view.
Visibility controls: Adjust page elements, such as which menus or sections display to end users, tailoring the integration experience for your brand.
Vendor options: Set preferences for vendor network displays within the iFrame.
This tab is focused on configuring the onboarding process for customers (payers). It lets you define how new users sign up and what information is required.
Flow control: Enable or disable onboarding for business and individual entities.
Field customization: Configure mandatory fields, required documents, and validation rules to ensure data accuracy.
Payment method collection: Determine when and how payment methods are gathered during onboarding.
This tab provides tools for defining custom metadata fields on invoices, allowing you to capture additional, custom information that is critical for your internal processes.
Field creation: Add custom fields—such as project IDs or reference codes—with various data types.
Validation rules: Set validation rules and conditional display options to ensure data integrity.
Association options: Decide whether metadata applies to the whole invoice or only to specific line items.
The Notifications tab enables you to configure and customize the alerts and notifications sent for key invoice, payment, and onboarding events.
Template customization: Design and adjust email templates with dynamic variables, conditional content, and custom HTML for a branded experience.
Endpoint settings: Configure URL endpoints for processing notifications in external systems.
Testing tools: Preview and test notification templates to ensure they work as expected before going live.
Changelog
This section provides a running log of updates, feature enhancements, and fixes, keeping you informed about the latest improvements and changes to the Mercoa platform.
