Skip to main content
This page introduces the main entities in the Revolv3 API and how they fit together. Use it as a map before you read the detailed guides for each concept.

​
Entities at a Glance

EntityRoleLearn more
MerchantYour Revolv3 account and its settings (processors, defaults, order channels).Merchant Settings, Order Processing Channels
CustomerOptional record for a payer; links payments, subscriptions, and payment methods.Customer
PaymentMethodStored payment credentials (card, ACH, etc.) used to charge a customer.Payment Method Guide, ACH Direct Debit
InvoiceBilling document for a charge; holds amount, line items, and state.Invoice Status, Get Invoices API
AttemptA single try to pay an invoice (e.g. one card charge or one ACH pull). One invoice can have multiple attempts.Get Invoice Details
SubscriptionRecurring billing plan; creates invoices on a schedule and optionally links to a customer and payment method.Create a Subscription, Billing Plans
For status values and enums used across these entities, see Statuses & enums.