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

Bill Payments

Create a bill payment

Changed on Oct 7, 2026

Record a payment for one or more carrier/vendor bills.

What happens

PaymentGroup record is created
Payment applications are created for each bill
Bill open balances are reduced
Load/service status updates to PAID when fully paid

Carrier factor payments

To pay a carrier's factor instead of the carrier directly, specify carrierFactorId in the request.

Overpayments

If allowOverpayment is true and payment exceeds bill totals, a credit memo is automatically created for the difference.

post/bill-payments

Request

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

Request body

paymentDatestring date required

Date of payment

Payment method used for the bill payment.

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

carrierFactorIdstring uuid

Carrier factor to pay. A bill payment has one payee, as in the TMS: one carrier, one vendor, or a carrier factor, which pays the bills of every carrier whose payment method is that factor. Bills of another payee are refused with 422.

referencestring

Check number, transaction ID, etc.

notesstring

Additional notes

allowOverpaymentboolean

Allow payment amount to exceed bill totals

Response

Bill payment created successfully

idstring uuid required

keystring nullable

Client-defined key

recipientType'CARRIER' | 'VENDOR' required

Type of recipient for the payment.

CARRIER: Payment to a carrier
VENDOR: Payment to a vendor

paymentDatestring date required

Date the payment was made

Payment method used for the bill payment.

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

referencestring nullable

Check number, transaction ID, etc.

notesstring nullable

Additional notes

totalAmountnumber required

Total payment amount (sum of all applications)

overpaymentnumber nullable

Amount paid in excess of invoice totals

overpaymentCreditMemoIdstring uuid nullable

Credit memo created for overpayment

qboIdstring nullable

QuickBooks Online bill payment ID

syncStatus'pending' | 'synced' | 'error' nullable

QuickBooks sync status

syncErrorstring nullable

QuickBooks sync error message

createdAtstring date-time required

updatedAtstring date-time nullable

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "carrier": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-CARRIER-SWIFT",
    "name": "Swift Transportation",
    "phoneNumber": "+1-555-987-6543",
    "email": "dispatch@swifttrans.com",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  },
  "vendor": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-VENDOR-ABC-001",
    "friendlyId": "V123456",
    "name": "ABC Warehouse Services",
    "email": "billing@abcwarehouse.com",
    "phone": "+1-555-123-4567",
    "status": "ACTIVE",
    "currency": "USD",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  }
}

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
- 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 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
- 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 13, 202653b310bb74a0 Revision changes
- warning
  added the new ZELLE enum value to the response property for the response status
- info
  added the new ZELLE enum value to the request property

Operation history