Bill Payments8

Bills11

Carrier Contacts5

Carrier Factors6

Carrier Payment Methods5

Carriers8

Companies5

Credit Memos8

Customer Contacts5

Customers8

Documents20

Invoices11

Loads13

Location Contacts5

Locations6

Payment Terms5

Payments6

Quotes6

Reference Data3

Saved Searches5

Search1

Services5

Shipments16

Stops5

Teams5

Users6

Vendor Contacts5

Vendor Payment Methods5

Vendors8

Webhooks

Event Notifications1

Payments

Create a payment

Changed on Oct 7, 2026

Record a customer payment applied to invoices.

What happens

Payment record is created
Specified amounts are applied to invoices
Invoice/order status updated to PAID when fully paid
Overpayment creates a credit memo automatically

Validations

Payment date must be >= invoice date for all applied invoices
Application amounts must not exceed invoice open balances
Customer must match invoice customer

post/payments

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/payments
Auth: HTTP bearer

Request body

customerIdstring uuid required

Customer making the payment

paymentDatestring date required

Date payment was received

Payment method type.

ACH_WIRE: ACH or wire transfer
ZELLE: Zelle payment
VENMO: Venmo payment
CHECK: Paper check
EFT_DIRECT_DEPOSIT: EFT direct deposit
E_TRANSFER: Electronic transfer
CREDIT_CARD: Credit card payment

referencestring

Check number, transaction ID, etc.

notesstring

Payment notes

Response

Payment created successfully

idstring uuid required

keystring nullable

Human-readable payment key

paymentDatestring date required

Date payment was received

Payment method type.

ACH_WIRE: ACH or wire transfer
ZELLE: Zelle payment
VENMO: Venmo payment
CHECK: Paper check
EFT_DIRECT_DEPOSIT: EFT direct deposit
E_TRANSFER: Electronic transfer
CREDIT_CARD: Credit card payment

referencestring nullable

Check number, transaction ID, etc.

notesstring nullable

Payment notes

currencystring nullable

Currency code

totalAmountnumber required

Total payment amount

overpaymentAmountnumber nullable

Amount in excess of invoice totals

overpaymentCreditMemoIdstring uuid nullable

Credit memo created from overpayment

shipmentIdsstring[]

Related shipment IDs

shipmentKeysstring[]

Related shipment friendly IDs

qboIdstring nullable

QuickBooks Online payment ID

createdAtstring date-time required

updatedAtstring date-time nullable

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "key": "PMT-00001",
  "customer": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-CUSTOMER-ACME",
    "name": "Acme Manufacturing Corp",
    "friendlyId": "A123456",
    "status": "ACTIVE",
    "phoneNumber": "+1-555-123-4567",
    "website": "https://acme-manufacturing.com",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  },
  "currency": "USD"
}

Changes

Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  added subschema #2 to the response body allOf list for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Aug 15, 2026ce0e9003047c Revision changes
- warning
  added the new BLOCKED enum value to the / response property for the response status
- warning
  added the new CLOSED enum value to the / response property for the response status
- warning
  added the new CONTACTED enum value to the / response property for the response status
- warning
  added the new NEW enum value to the / response property for the response status
- warning
  added the new NURTURING enum value to the / response property for the response status
- warning
  added the new PENDING enum value to the / response property for the response status
- warning
  added the new QUALIFIED enum value to the / response property for the response status
- warning
  added the new QUOTED enum value to the / response property for the response status
- info
  removed the CHURNED enum value from the / response property for the response status
- info
  removed the PROSPECT enum value from the / response property for the response status

Operation history