RevKeenDocs

Glossary

Canonical definitions for terms used across RevKeen documentation

A

ACH

Automated Clearing House. A US bank transfer network used for direct debit payments.

ARR (Annual Recurring Revenue)

The annualized value of all active subscriptions. Calculated as MRR x 12.

B

Billing Interval

The frequency at which a subscription is billed (weekly, monthly, quarterly, annually).

C

Card on File (COF)

A payment method stored securely for future use. RevKeen stores a gateway token, never raw card numbers. See also: MIT, Tokenization.

Chargeback

A payment reversal initiated by the cardholder's bank. In RevKeen, chargebacks appear as disputes. See Disputes.

A shareable URL that opens a hosted payment page. Created from a product + price combination.

Checkout Session

A temporary session created when a customer begins the checkout process. Contains product, price, and customer details.

Collect.js

NMI's hosted payment field library that tokenizes card data client-side. Ensures raw card numbers never touch RevKeen servers.

Connector

The Tauri desktop application that bridges RevKeen Cloud and PAX terminal devices for in-person payments. See Terminal.

Credit Note

A document issued to reduce the amount owed on an invoice. Can trigger a refund, void, or account credit.

Customer Portal

A hosted web application where customers can manage subscriptions, view invoices, and update payment methods. See Customer Portal.

D

Decline Code

A numeric code returned by the payment gateway explaining why a transaction was rejected. Used by dunning to classify hard vs soft declines.

Dunning

The process of recovering failed subscription payments through automated retries, email reminders, and escalation. See Dunning.

Dispute

A formal challenge to a payment, typically initiated by the cardholder's bank. RevKeen tracks dispute lifecycle from open through resolution. See Disputes.

E

Elavon

A global payment processor (acquirer) that provides the underlying payment rails for RevKeen transactions.

G

Gateway

A payment processor that handles the actual card transaction. RevKeen is gateway-agnostic and currently supports NMI and Elavon.

Grace Period

The number of days a subscription retains access after a payment fails, while retries are in progress.

H

Health Score

A 0-100 composite score measuring a customer's payment reliability. Based on punctuality, dunning depth, failure rate, tenure, and method health. See Customer Health Scores.

I

Idempotency

The property of an operation that produces the same result whether executed once or multiple times. Critical for payment operations to prevent double charges.

Interchange Fee

The fee charged by the cardholder's bank on each transaction. Part of the total processing cost visible in margin tracking.

Invoice

A payment request sent to a customer. Contains line items, tax calculations, and payment terms. See Invoices.

M

Margin Intelligence

RevKeen's unique capability to track all costs (processing, gateway, refunds, chargebacks) and attribute them per transaction, customer, and product.

Merchant

A business using RevKeen to collect payments. Each merchant has isolated data, settings, and API keys.

Meter

A usage-based billing construct that tracks consumption events. Meters aggregate usage and generate invoices based on configured pricing tiers.

MIT (Merchant-Initiated Transaction)

A transaction initiated by the merchant without the cardholder present, using a stored card on file. Subscription renewals are MIT transactions.

MRR (Monthly Recurring Revenue)

The normalized monthly value of all active subscriptions. The primary metric for subscription businesses.

N

NMI

Network Merchants Inc. The payment gateway used by RevKeen to process card transactions.

P

See Checkout Link.

Payment Method

A stored means of payment (card, bank account) associated with a customer. RevKeen stores gateway tokens, not raw credentials.

Price

A specific pricing configuration for a product. A product can have multiple prices (e.g., monthly and annual).

Product

A sellable item in RevKeen. Products have a billing type (one-time, recurring, usage) and fulfillment type (service, digital, physical).

Proration

Adjusting charges when a subscription changes mid-billing-cycle. For example, upgrading from a $10/mo to $20/mo plan mid-month charges the difference.

S

Settlement

The process of transferring captured funds from the payment gateway to the merchant's bank account.

SSE (Server-Sent Events)

The transport used for real-time updates from RevKeen to the dashboard. One-way server-to-browser push.

Subscription

A recurring billing relationship between a merchant and customer. Defined by a product, price, billing interval, and payment method.

T

Tokenization

Replacing sensitive payment data (card numbers) with a non-sensitive token. The gateway stores the real data; RevKeen only stores the token.

Transaction

A financial movement in RevKeen. Sales, refunds, voids, and disputes are all transaction types stored in the unified transaction model.

U

Unkey

The API key management service used by RevKeen to issue, scope, and rate-limit API keys.

V

Vault

The secure storage of payment methods. RevKeen's vault stores gateway tokens, not raw card data. See PCI Compliance.

Void

Canceling a transaction before it settles. Unlike a refund, a void prevents the charge from ever appearing on the customer's statement.

W

Webhook

An HTTP callback triggered by events in RevKeen (payment completed, subscription canceled, etc.). See Webhooks.