Tier 1 — Push Data In

Payments

Record payments against prospects from any processor — wire transfers, cash, in-person, or custom integrations. Payments flow into Callix's unified customerPayments table and are included in all revenue metrics.

Endpoints

POST	`/payments`	Record a payment against a prospect
GET	`/payments`	List payments with optional filters

`POST /payments`

Records a payment. Callix auto-matches the prospect by email — if no match is found, the payment is stored as unmatched and can be manually linked in the dashboard.

Request body

json

{
  "amount": 2500.00,
  "currency": "USD",
  "processor": "wire",
  "occurredAt": 1748000000000,
  "prospectEmail": "jane@example.com",
  "notes": "Program enrollment"
}

amountnumberPayment amount (e.g. 2500.00)

currencystringISO 4217 currency code (e.g. USD, EUR)

processorstringProcessor label — e.g. "wire", "cash", "stripe", "custom"

occurredAtnumberUnix ms timestamp of when the payment occurred

prospectEmailstring?Used to match the payment to a prospect

prospectPhonestring?Fallback match if no email provided

externalIdstring?Processor-side transaction ID for deduplication

notesstring?Optional free-text note stored with the payment

`GET /payments`

Returns a paginated list of payment records for the account.

sincenumberUnix ms — return payments after this time

untilnumberUnix ms — return payments before this time

prospectIdstringFilter to a specific prospect

limitnumberMax records (default 50, max 100)

cursorstringPagination cursor