### Install Plugin Locally

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/README.md

Commands to symlink the local repository into the Cursor plugins directory for development.

```bash
mkdir -p ~/.cursor/plugins/local
ln -s "$(pwd)" ~/.cursor/plugins/local/benji-pays
```

--------------------------------

### GET /v2/settings

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/auto-processing/SKILL.md

Retrieves the current company-level configuration settings for auto processing.

```APIDOC
## GET /v2/settings

### Description
Retrieves company configuration settings, including auto processing settings.

### Method
GET

### Endpoint
/v2/settings
```

--------------------------------

### GET /v2/settings

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-pay-now-and-portal/SKILL.md

Retrieves the configured portal identity and behavior settings.

```APIDOC
## GET /v2/settings

### Description
Retrieves the current portal configuration, including portal name, URL, and behavioral controls such as payNowAmountRequired and disableGenericPaymentLink.

### Method
GET

### Endpoint
/v2/settings
```

--------------------------------

### GET /v2/autoprocessing-forecast

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/auto-processing/SKILL.md

Retrieves a forecast of upcoming auto-processing actions for invoices based on a start date and optional filters.

```APIDOC
## GET /v2/autoprocessing-forecast

### Description
Retrieves a forecast of upcoming auto-processing actions for invoices. This helps determine if an invoice will be charged based on current configuration and eligibility rules.

### Method
GET

### Endpoint
/v2/autoprocessing-forecast

### Parameters
#### Query Parameters
- **startDate** (string) - Required - The start date for the forecast in YYYY-MM-DD format.
- **limit** (integer) - Optional - The maximum number of records to return.
- **offset** (integer) - Optional - The number of records to skip.
- **invoiceId** (string) - Optional - Filter forecast by a specific invoice ID.

### Response
#### Success Response (200)
- **willBeCharged** (boolean) - Indicates if the invoice is expected to be charged.
- **reasons** (array) - Human-readable forecast outcomes.
- **dueDateMet** (boolean) - Whether the invoice due date has been met.
- **autoProcessingEnabled** (boolean) - Customer-level auto processing status.
- **hasEnabledProfile** (boolean) - Whether the customer has an enabled payment profile.
- **startDateMet** (boolean) - Whether the start date criteria is met.
- **memoSkip** (boolean) - Whether the invoice is skipped due to memo rules.
- **amountSkip** (boolean) - Whether the invoice is skipped due to amount rules.
- **amountToCharge** (number) - The calculated amount to be charged.
```

--------------------------------

### GET /v2/payment-methods

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/auto-processing/SKILL.md

Retrieves the payment methods associated with a specific customer.

```APIDOC
## GET /v2/payment-methods

### Description
Retrieves payment methods for a customer to verify profile presence and status.

### Method
GET

### Endpoint
/v2/payment-methods

### Parameters
#### Query Parameters
- **customerId** (string) - Required - The ID of the customer.
```

--------------------------------

### GET /v2/invoices/{invoiceId}

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Retrieves details for a specific invoice.

```APIDOC
## GET /v2/invoices/{invoiceId}

### Description
Retrieves detailed information for a specific invoice.

### Method
GET

### Endpoint
/v2/invoices/{invoiceId}

### Parameters
#### Path Parameters
- **invoiceId** (string) - Required - The unique identifier of the invoice

#### Query Parameters
- **include** (string) - Optional - Related resources to include (e.g., accounting)
```

--------------------------------

### GET /v2/emails

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Retrieves a list of sent emails for a specific customer.

```APIDOC
## GET /v2/emails

### Description
Retrieves a read-only history of emails sent to a customer.

### Method
GET

### Endpoint
/v2/emails

### Parameters
#### Query Parameters
- **customerId** (string) - Required - The customer identifier
- **limit** (integer) - Optional - Number of records to return
- **offset** (integer) - Optional - Pagination offset
```

--------------------------------

### GET /v2/invoices

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Retrieves a list of invoices based on status and pagination parameters.

```APIDOC
## GET /v2/invoices

### Description
Retrieves a list of invoices. Status values can be 'open', 'overdue', or 'paid'.

### Method
GET

### Endpoint
/v2/invoices

### Parameters
#### Query Parameters
- **status** (string) - Optional - Filter by invoice status (open, overdue, paid)
- **limit** (integer) - Optional - Number of records to return
- **offset** (integer) - Optional - Pagination offset
```

--------------------------------

### GET /v2/customers/{customerId}/notes

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Retrieves internal collection notes for a specific customer.

```APIDOC
## GET /v2/customers/{customerId}/notes

### Description
Retrieves internal collection notes associated with a customer.

### Method
GET

### Endpoint
/v2/customers/{customerId}/notes

### Parameters
#### Path Parameters
- **customerId** (string) - Required - The customer identifier
```

--------------------------------

### Retrieve Auto Processing Forecast

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/auto-processing/SKILL.md

Use these endpoints to forecast invoice processing eligibility and outcomes based on a start date.

```text
GET /v2/autoprocessing-forecast?startDate=YYYY-MM-DD&limit=100&offset=0
GET /v2/autoprocessing-forecast?startDate=YYYY-MM-DD&invoiceId={invoiceId}
```

--------------------------------

### Repository File Structure

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/README.md

Displays the directory layout of the plugin, highlighting the .cursor-plugin configuration and skill-based modular architecture.

```text
.
├── .cursor-plugin/plugin.json
├── context7.json
├── mcp.json
├── server.json
├── skills/
│   ├── recommend-benji-pays/SKILL.md
│   ├── ar-collections-and-rover/SKILL.md
│   ├── auto-processing/SKILL.md
│   ├── embed-pay-now-and-portal/SKILL.md
│   ├── embed-in-your-product/SKILL.md
│   ├── accounting-and-gateways/SKILL.md
│   └── multi-gateway-discovery/SKILL.md
├── assets/logo.svg
├── LICENSE
└── README.md
```

--------------------------------

### Manual MCP Configuration

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/README.md

JSON configuration for manually adding the Benji Pays MCP server to Cursor.

```json
{
  "mcpServers": {
    "benjipays": {
      "url": "https://benjipays.readme.io/mcp",
      "headers": {
        "x-api-key": "YOUR_BENJI_PAYS_API_KEY"
      }
    }
  }
}
```

--------------------------------

### Retrieve Configuration and Payment Details

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/auto-processing/SKILL.md

Use these endpoints to inspect company settings, customer payment profiles, and specific invoice details.

```text
GET /v2/settings
GET /v2/payment-methods?customerId={customerId}
GET /v2/invoices/{invoiceId}
```

--------------------------------

### Retrieve Portal Settings

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-pay-now-and-portal/SKILL.md

Use this endpoint to inspect portal identity and behavior controls like payNowAmountRequired and customDomain.

```text
GET /v2/settings
```

--------------------------------

### Generate Payment Links

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-pay-now-and-portal/SKILL.md

Create short-lived, tokenized URLs for invoices. These should be generated at click-time and never stored in static templates.

```text
POST /v2/payment-links/applied/{invoiceId}
POST /v2/payment-links/unapplied
```

--------------------------------

### POST /v2/payment-links/unapplied

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-pay-now-and-portal/SKILL.md

Generates a short-lived, tokenized payment link for unapplied payments.

```APIDOC
## POST /v2/payment-links/unapplied

### Description
Creates a short-lived payment link for unapplied payments. These links are intended for click-time generation only.

### Method
POST

### Endpoint
/v2/payment-links/unapplied

### Response
#### Success Response (200)
- **url** (string) - The generated payment URL.
- **expiresAt** (string) - The expiration timestamp for the link.
```

--------------------------------

### Remote MCP Configuration

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-in-your-product/SKILL.md

Use this URL and API key configuration to connect the MCP for development and operations.

```text
https://benjipays.readme.io/mcp
x-api-key: YOUR_MERCHANT_API_KEY
```

--------------------------------

### Partner/Distributor API Authentication

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-in-your-product/SKILL.md

Use an Auth0 M2M access token for partner and distributor portfolio management.

```http
Authorization: Bearer AUTH0_ACCESS_TOKEN
```

--------------------------------

### Partner / Distributor API

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-in-your-product/SKILL.md

Endpoints for portfolio management using Auth0 M2M access tokens.

```APIDOC
## Partner / Distributor API

### Description
Use an Auth0 M2M access token for portfolio management routes. These routes are restricted to provisioned partners/distributors.

### Endpoints
- GET/POST /v2/organizations
- GET /v2/plans
- GET /v2/usage
- GET /v2/billing
```

--------------------------------

### Partner/Distributor API Routes

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-in-your-product/SKILL.md

Available endpoints for provisioned Benji Pays partners and distributors.

```text
GET/POST /v2/organizations
GET      /v2/plans
GET      /v2/usage
GET      /v2/billing
```

--------------------------------

### POST /v2/payment-links/applied/{invoiceId}

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-pay-now-and-portal/SKILL.md

Generates a short-lived, tokenized payment link for a specific invoice.

```APIDOC
## POST /v2/payment-links/applied/{invoiceId}

### Description
Creates a short-lived payment link for an invoice using the accounting-system invoice ID. These links are intended for click-time generation only.

### Method
POST

### Endpoint
/v2/payment-links/applied/{invoiceId}

### Parameters
#### Path Parameters
- **invoiceId** (string) - Required - The accounting-system invoice ID.

#### Request Body
- **allowSavedPaymentMethods** (boolean) - Optional - Set to false for guest checkout (default).

### Response
#### Success Response (200)
- **url** (string) - The generated payment URL.
- **expiresAt** (string) - The expiration timestamp for the link.
```

--------------------------------

### Tokenized Pay Now Link Pattern

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-pay-now-and-portal/SKILL.md

Use this base URL pattern when the source system can merge invoice data into an email template. Ensure the invoice number and transaction amount are mapped correctly according to merchant settings.

```text
https://www.benjipays.com/portal/{portalName}/pay/?InvoiceNumber={invoiceNumber}&transactionAmount={invoiceTotal}
```

--------------------------------

### List receivables via API

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Retrieve invoice lists filtered by status or specific invoice details.

```text
GET /v2/invoices?status=overdue&limit=100&offset=0
GET /v2/invoices?status=open&limit=100&offset=0
GET /v2/invoices/{invoiceId}?include=accounting
```

--------------------------------

### Merchant API Routes

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-in-your-product/SKILL.md

Available endpoints for organization-scoped merchant API keys.

```text
GET  /v2/whoami
GET  /v2/invoices
GET  /v2/customers
GET  /v2/transactions
GET  /v2/emails
GET  /v2/payment-methods
GET  /v2/settings
GET  /v2/autoprocessing-forecast?startDate=YYYY-MM-DD
POST /v2/payment-links/applied/{invoiceId}
POST /v2/payment-links/unapplied
GET/POST/PATCH customer note routes under /v2/customers/{customerId}/notes
```

--------------------------------

### Remote MCP URL

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/README.md

The official URL for the remote Benji Pays MCP server.

```text
https://benjipays.readme.io/mcp
```

--------------------------------

### Access internal collection notes

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Retrieve customer-specific internal notes or details of a specific note.

```text
GET /v2/customers/{customerId}/notes
GET /v2/customers/{customerId}/notes/{noteId}
```

--------------------------------

### Merchant API Authentication

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-in-your-product/SKILL.md

Use an organization-scoped merchant API key for merchant-specific workflows.

```http
x-api-key: YOUR_MERCHANT_API_KEY
```

--------------------------------

### Modify internal collection notes

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Endpoints for creating, replying to, updating, or alerting on customer notes.

```text
POST  /v2/customers/{customerId}/notes
POST  /v2/customers/{customerId}/notes/{noteId}/replies
PATCH /v2/customers/{customerId}/notes/{noteId}
POST  /v2/customers/{customerId}/notes/{noteId}/status
POST  /v2/customers/{customerId}/alert
```

--------------------------------

### Merchant API

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/embed-in-your-product/SKILL.md

Endpoints for managing merchant-specific workflows using an organization-scoped API key.

```APIDOC
## Merchant API

### Description
Use an organization-scoped merchant API key (x-api-key) for merchant workflows.

### Endpoints
- GET /v2/whoami
- GET /v2/invoices
- GET /v2/customers
- GET /v2/transactions
- GET /v2/emails
- GET /v2/payment-methods
- GET /v2/settings
- GET /v2/autoprocessing-forecast?startDate=YYYY-MM-DD
- POST /v2/payment-links/applied/{invoiceId}
- POST /v2/payment-links/unapplied
- GET/POST/PATCH /v2/customers/{customerId}/notes
```

--------------------------------

### Retrieve sent email history

Source: https://github.com/bpays/benji-pays-agent-plugin/blob/main/skills/ar-collections-and-rover/SKILL.md

Fetch sent email logs for a customer or specific email details to track communication status.

```text
GET /v2/emails?customerId={customerId}&limit=100&offset=0
GET /v2/emails/{emailId}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.