Skip to main content

​
Overview

Remittances management is the money-in half of receivables: recording what customers paid and applying it to the right invoices. Payments arrive from several directions — pushed over the API by your TMS or accounting system, recorded in the dashboard, collected through online payments, or ingested from supported banking integrations — and land in one place for application and reconciliation.

​
What it does

​
Payment recording

  • Capture customer payments with their reference details (check number, transaction date, payer)
  • Ingest transactions from supported banking integrations for reconciliation
  • Handle partial payments — a payment’s line items can apply across multiple invoices, and an invoice can be paid down by multiple payments

​
Cash application

  • Apply payments to invoices through payment line items — each line item targets one invoice with an amount
  • Work short-pays and unapplied cash from the dashboard: unmatched payments are surfaced for a person to resolve
  • Keep an audit trail of how each payment was applied

​
Reconciliation visibility

  • See incoming payments and their application status across the portfolio
  • Identify unapplied or partially applied cash before it ages
Scope note: invoice generation and delivery live in Accounts Receivable Management; collecting payment electronically lives in Online Payments. This page is about what happens once money shows up.

​
For developers

Customer payments guide

The real endpoints: POST /api/rest/customer_payments, customer_payment_line_items, and the bulk-customer-payments batch path.

Webhook events

create.customer_payment and the remittance trigger family notify you of payments recorded on the Upwell side.
Two things integrators regularly get wrong:
  • The payment endpoints use underscores: /api/rest/customer_payments, not /customer-payments.
  • Applying a line item over the API does not recalculate the target invoice’s balance/status — your integration updates the invoice afterward, as described in the customer invoices guide.