Skip to content
API Reference/
/
Update vendor payment met...

MVMNT API (1.0.0)

The MVMNT API enables you to automate freight brokerage workflows by integrating directly with our Transportation Management System.

Postman setup guide: API Clients.

Authentication

OAuth 2.0 client credentials flow. See Authentication Guide for details.

Token Endpoint

POST https://api.mvmnt.io/oauth2/token

Request

Headers:

Content-Type: application/x-www-form-urlencoded

Body Parameters:

grant_type=client_credentials
client_id=YOUR_CLIENT_ID
client_secret=YOUR_CLIENT_SECRET

Example Request

curl -X POST https://api.mvmnt.io/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Success Response

Status: 200 OK

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Response Fields:

  • access_token: JWT Bearer token to use for API requests
  • token_type: Always Bearer
  • expires_in: Token lifetime in seconds (3600 = 1 hour)

Idempotency

Mutating requests (POST, PATCH, DELETE) accept an optional Idempotency-Key header (up to 255 characters). Retrying a request with the same key and the same body returns the original result instead of repeating the operation; reusing a key with a different body fails. Keys are scoped to your organization — keys chosen by other tenants can never collide with yours. Use a stable identifier from your system (for example your own record id plus the action) rather than a random value per attempt.

Download OpenAPI description
openapi.json
openapi.yaml
openapi-3.0.yaml (legacy tooling)
Postman Collection
Postman Environment — Demo
Postman Environment — Production
Overview
URL
https://docs.mvmnt.io
MVMNT Support
support@mvmnt.io
License
Proprietary
Languages
Servers
Production
https://api.mvmnt.io/v1
Demo (non-production)
https://api.demo.mvmnt.io/v1

Carriers

Carrier management operations

Operations

Carrier Contacts

Carrier contact management operations

Operations

Carrier Factors

Carrier factor (factoring company) management operations

Operations

Carrier Payment Methods

Carrier payment method management operations

Operations

Companies

Company management operations

Operations

Credit Memos

AR credit memo management operations. Credit memos represent customer credits that can be applied to invoices.

Operations

Bills

AP bill management operations. Bills represent carrier and vendor invoices to be paid.

Operations

Bill Payments

AP bill payment management operations. Bill payments record payments made to carriers and vendors.

Operations

Customers

Customer management operations

Operations

Customer Contacts

Customer contact management operations

Operations

Documents

Document management operations. Documents are files (PDFs, images) that can be attached to orders, loads, or services.

Operations

Invoices

AR invoice management operations. Invoices represent customer billing for shipment services.

Operations

Loads

Load management operations. Loads represent carrier execution - which carrier is moving the freight.

Operations

Locations

Location management operations

Operations

Location Contacts

Location contact management operations

Operations

Payment Terms

Payment term management operations

Operations

Reference Data

Read-only catalogs (equipment, charge codes, special requirements) referenced by id from other resources.

Every catalog also answers on its short top-level path, so GET /v1/charge-codes and GET /v1/reference-data/charge-codes are the same endpoint. The documented /reference-data/* form is canonical — it keeps the catalogs grouped here as more are added (port codes, cities, zip codes) — and the short form is a convenience alias.

Operations

Payments

AR payment management operations. Payments represent received customer payments applied to invoices.

Operations

Quotes

Quote management operations. Quotes are pricing requests/responses that can be converted to shipments.

Operations

Saved Searches

Saved search management operations

Operations

Services

Service (vended service) management operations. Services represent non-carrier vendor work (drayage, customs, warehousing).

Operations

Shipments

Shipment tracking and management operations. Shipments contain orders, loads, and services.

Operations

Teams

Team management operations

Operations

Users

User management operations

Operations

Vendors

Vendor management operations

Operations

Vendor Contacts

Vendor contact management operations

Operations

Vendor Payment Methods

Vendor payment method management operations

Operations

Filter vendor payment methods

Request

Query vendor payment methods using flexible filter criteria with AND/OR logic.

By default, only non-deleted payment methods are returned (deletedAt: { isNull: true }). Override this by explicitly setting deletedAt filter criteria.

Vendor payment methods define how and where payments are sent for a specific vendor.

Security
BearerAuth
Bodyapplication/jsonrequired
filterobject(VendorPaymentMethodFilter)

Filter criteria (optional - omit to return all vendor payment methods).

Note: deletedAt automatically defaults to { isNull: true } unless explicitly overridden.

Example: {"and":[{"vendorId":{"equalTo":"770e8400-e29b-41d4-a716-446655440000"}},{"isPreferred":{"equalTo":true}}]}
pageSizeinteger[ 1 .. 250 ]

Number of results per page

Default 50
Example: 50
cursorstring

Pagination cursor for next page

curl -i -X POST \
  https://api.mvmnt.io/v1/vendor-payment-methods/filter \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "filter": {
      "and": [
        {
          "vendorId": {
            "equalTo": "770e8400-e29b-41d4-a716-446655440000"
          }
        },
        {
          "isPreferred": {
            "equalTo": true
          }
        }
      ]
    },
    "pageSize": 50
  }'

Responses

Filtered vendor payment methods with pagination

Bodyapplication/json
dataArray of objects(VendorPaymentMethod)required
idstring(uuid)read-onlyrequired

Unique vendor payment method identifier

Example: "550e8400-e29b-41d4-a716-446655440000"
vendorIdstring(uuid)read-onlyrequired

Vendor profile ID (read-only after creation).

This field cannot be changed after the payment method is created.

Example: "770e8400-e29b-41d4-a716-446655440000"
vendorobject(VendorReference)required

Vendor profile reference with full details

idstring(uuid)required

Vendor UUID

Example: "550e8400-e29b-41d4-a716-446655440000"
keystring or null<= 512 characters

Client-defined reference ID if set

Example: "ERP-VENDOR-ABC-001"
friendlyIdstringrequired

Human-readable vendor identifier

Example: "V123456"
namestringrequired

Vendor legal name

Example: "ABC Warehouse Services"
emailstring or null(email)

Primary email address

Example: "billing@abcwarehouse.com"
phonestring or null

Primary phone number

Example: "+1-555-123-4567"
statusstring or null

Vendor status

Example: "ACTIVE"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
createdAtstring(date-time)required

When the vendor was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)required

When the vendor was last updated

Example: "2025-01-15T14:30:00Z"
paymentMethodTypestring(vendor-payment-methods_PaymentMethodType)required

How payment is made

Enum"ACH_WIRE""ZELLE""VENMO""ACH""CHECK""WIRE""CAD_EFT""TRIUMPH_PAY""COMCHECK""EFS"
statusstring or null

Payment method status

Example: "ACTIVE"
isPreferredboolean or null

Whether this is the preferred payment method for the vendor

Example: true
emailstring or null(email)

Email address for payment notifications

Example: "payments@vendor.com"
phonestring or null

Phone number for payment contact

Example: "+1-555-123-4567"
companyNamestring or null

Company name for this payment method (may differ from vendor name)

Example: "Vendor Payments LLC"
usernamestring or null

Username for payment platforms (e.g., Zelle, Venmo)

Example: "vendor_payments"
bankNamestring or null

Bank name

Example: "Chase Bank"
bankAddressstring or null

Bank address

Example: "123 Bank Street, Dallas, TX 75201"
accountNamestring or null

Bank account holder name

Example: "Vendor Services Inc"
accountNumberstring or null

Bank account number (masked in responses)

Example: "****1234"
abaAchstring or null

ABA/ACH routing number for electronic transfers

Example: "021000021"
wirestring or null

Wire transfer routing number

Example: "026009593"
swiftCodestring or null

SWIFT/BIC code for international transfers

Example: "CHASUS33"
eftInstitutionstring or null

EFT institution number (Canadian banking)

Example: "001"
eftTransitstring or null

EFT transit number (Canadian banking)

Example: "00010"
clabestring or null

CLABE number (Mexican banking identifier)

Example: "012180001234567897"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
paymentTermPaymentTermReference (object) or null

Payment terms for this payment method

Any of:

Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.

createdAtstring(date-time)read-onlyrequired

When the payment method was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)read-onlyrequired

When the payment method was last updated

Example: "2025-01-15T14:30:00Z"
deletedAtstring or null(date-time)read-only

When the payment method was soft deleted (null if active)

Example: null
deletedByUserReference (object) or nullread-only

User who deleted this payment method

Any of:

Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key.

Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.

pageInfoobject(PaginationInfo)required
pageSizeintegerrequired

Number of items per page

Example: 50
hasNextPagebooleanrequired

Whether there are more pages

Example: true
hasPreviousPageboolean

Whether there are previous pages

Example: false
endCursorstring or null

Cursor for the next page (null if no next page)

Example: "eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCJ9"
Response
application/json
{
  "data": [
    { … }
  ],
  "pageInfo": {
    "pageSize": 50,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "endCursor": "eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCJ9"
  }
}

Create vendor payment method

Request

Create a new vendor payment method.

Important: The vendorId cannot be changed after creation.

Security
BearerAuth
Bodyapplication/jsonrequired
vendorIdstring(uuid)required

Vendor profile ID.

IMPORTANT: This field cannot be changed after creation.

Example: "770e8400-e29b-41d4-a716-446655440000"
paymentMethodTypestring(vendor-payment-methods_PaymentMethodType)required

How payment is made

Enum"ACH_WIRE""ZELLE""VENMO""ACH""CHECK""WIRE""CAD_EFT""TRIUMPH_PAY""COMCHECK""EFS"
statusstring

Payment method status

Example: "ACTIVE"
isPreferredboolean

Whether this is the preferred payment method

Example: true
emailstring(email)

Email address for payment notifications

Example: "payments@vendor.com"
phonestring

Phone number for payment contact

Example: "+1-555-123-4567"
companyNamestring

Company name for this payment method

Example: "Vendor Payments LLC"
usernamestring

Username for payment platforms

Example: "vendor_payments"
bankNamestring

Bank name

Example: "Chase Bank"
bankAddressstring

Bank address

Example: "123 Bank Street, Dallas, TX 75201"
accountNamestring

Bank account holder name

Example: "Vendor Services Inc"
accountNumberstring

Bank account number

Example: "1234567890"
abaAchstring

ABA/ACH routing number

Example: "021000021"
wirestring

Wire transfer routing number

Example: "026009593"
swiftCodestring

SWIFT/BIC code for international transfers

Example: "CHASUS33"
eftInstitutionstring

EFT institution number (Canadian banking)

Example: "001"
eftTransitstring

EFT transit number (Canadian banking)

Example: "00010"
clabestring

CLABE number (Mexican banking)

Example: "012180001234567897"
currencystring

Preferred currency code (ISO 4217)

Example: "USD"
paymentTermIdstring(uuid)

Payment term ID

Example: "550e8400-e29b-41d4-a716-446655440002"
curl -i -X POST \
  https://api.mvmnt.io/v1/vendor-payment-methods \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "vendorId": "770e8400-e29b-41d4-a716-446655440000",
    "paymentMethodType": "ACH",
    "isPreferred": true,
    "bankName": "Chase Bank",
    "accountName": "Vendor Services Inc",
    "accountNumber": "1234567890",
    "abaAch": "021000021",
    "currency": "USD"
  }'

Responses

Vendor payment method created successfully

Bodyapplication/json
idstring(uuid)read-onlyrequired

Unique vendor payment method identifier

Example: "550e8400-e29b-41d4-a716-446655440000"
vendorIdstring(uuid)read-onlyrequired

Vendor profile ID (read-only after creation).

This field cannot be changed after the payment method is created.

Example: "770e8400-e29b-41d4-a716-446655440000"
vendorobject(VendorReference)required

Vendor profile reference with full details

idstring(uuid)required

Vendor UUID

Example: "550e8400-e29b-41d4-a716-446655440000"
keystring or null<= 512 characters

Client-defined reference ID if set

Example: "ERP-VENDOR-ABC-001"
friendlyIdstringrequired

Human-readable vendor identifier

Example: "V123456"
namestringrequired

Vendor legal name

Example: "ABC Warehouse Services"
emailstring or null(email)

Primary email address

Example: "billing@abcwarehouse.com"
phonestring or null

Primary phone number

Example: "+1-555-123-4567"
statusstring or null

Vendor status

Example: "ACTIVE"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
createdAtstring(date-time)required

When the vendor was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)required

When the vendor was last updated

Example: "2025-01-15T14:30:00Z"
paymentMethodTypestring(vendor-payment-methods_PaymentMethodType)required

How payment is made

Enum"ACH_WIRE""ZELLE""VENMO""ACH""CHECK""WIRE""CAD_EFT""TRIUMPH_PAY""COMCHECK""EFS"
statusstring or null

Payment method status

Example: "ACTIVE"
isPreferredboolean or null

Whether this is the preferred payment method for the vendor

Example: true
emailstring or null(email)

Email address for payment notifications

Example: "payments@vendor.com"
phonestring or null

Phone number for payment contact

Example: "+1-555-123-4567"
companyNamestring or null

Company name for this payment method (may differ from vendor name)

Example: "Vendor Payments LLC"
usernamestring or null

Username for payment platforms (e.g., Zelle, Venmo)

Example: "vendor_payments"
bankNamestring or null

Bank name

Example: "Chase Bank"
bankAddressstring or null

Bank address

Example: "123 Bank Street, Dallas, TX 75201"
accountNamestring or null

Bank account holder name

Example: "Vendor Services Inc"
accountNumberstring or null

Bank account number (masked in responses)

Example: "****1234"
abaAchstring or null

ABA/ACH routing number for electronic transfers

Example: "021000021"
wirestring or null

Wire transfer routing number

Example: "026009593"
swiftCodestring or null

SWIFT/BIC code for international transfers

Example: "CHASUS33"
eftInstitutionstring or null

EFT institution number (Canadian banking)

Example: "001"
eftTransitstring or null

EFT transit number (Canadian banking)

Example: "00010"
clabestring or null

CLABE number (Mexican banking identifier)

Example: "012180001234567897"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
paymentTermPaymentTermReference (object) or null

Payment terms for this payment method

Any of:

Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.

createdAtstring(date-time)read-onlyrequired

When the payment method was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)read-onlyrequired

When the payment method was last updated

Example: "2025-01-15T14:30:00Z"
deletedAtstring or null(date-time)read-only

When the payment method was soft deleted (null if active)

Example: null
deletedByUserReference (object) or nullread-only

User who deleted this payment method

Any of:

Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key.

Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.

Response
application/json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "vendorId": "770e8400-e29b-41d4-a716-446655440000",
  "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"
  },
  "paymentMethodType": "ACH",
  "status": "ACTIVE",
  "isPreferred": true,
  "email": "payments@vendor.com",
  "phone": "+1-555-123-4567",
  "companyName": "Vendor Payments LLC",
  "username": "vendor_payments",
  "bankName": "Chase Bank",
  "bankAddress": "123 Bank Street, Dallas, TX 75201",
  "accountName": "Vendor Services Inc",
  "accountNumber": "****1234",
  "abaAch": "021000021",
  "wire": "026009593",
  "swiftCode": "CHASUS33",
  "eftInstitution": "001",
  "eftTransit": "00010",
  "clabe": "012180001234567897",
  "currency": "USD",
  "paymentTerm": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-PAYTERM-NET30",
    "name": "Net 30",
    "description": "Payment due 30 days from invoice date",
    "days": 30,
    "quickPayFee": 0.05,
    "apOnly": false,
    "doNotUse": false,
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z",
    "deletedAt": null
  },
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z",
  "deletedAt": null,
  "deletedBy": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-USER-12345",
    "email": "john.doe@example.com",
    "name": "John Doe",
    "phone": "+1-555-123-4567",
    "phoneExt": "123",
    "status": "ACTIVE",
    "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z",
    "deletedAt": null
  }
}

Get vendor payment method

Request

Retrieve a single vendor payment method by its unique identifier.

Returns full details including banking information and associated vendor references.

Security
BearerAuth
Path
idstringrequired

Resource ID (UUID) or client key

Example: 550e8400-e29b-41d4-a716-446655440000
curl -i -X GET \
  https://api.mvmnt.io/v1/vendor-payment-methods/550e8400-e29b-41d4-a716-446655440000 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Vendor payment method found

Bodyapplication/json
idstring(uuid)read-onlyrequired

Unique vendor payment method identifier

Example: "550e8400-e29b-41d4-a716-446655440000"
vendorIdstring(uuid)read-onlyrequired

Vendor profile ID (read-only after creation).

This field cannot be changed after the payment method is created.

Example: "770e8400-e29b-41d4-a716-446655440000"
vendorobject(VendorReference)required

Vendor profile reference with full details

idstring(uuid)required

Vendor UUID

Example: "550e8400-e29b-41d4-a716-446655440000"
keystring or null<= 512 characters

Client-defined reference ID if set

Example: "ERP-VENDOR-ABC-001"
friendlyIdstringrequired

Human-readable vendor identifier

Example: "V123456"
namestringrequired

Vendor legal name

Example: "ABC Warehouse Services"
emailstring or null(email)

Primary email address

Example: "billing@abcwarehouse.com"
phonestring or null

Primary phone number

Example: "+1-555-123-4567"
statusstring or null

Vendor status

Example: "ACTIVE"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
createdAtstring(date-time)required

When the vendor was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)required

When the vendor was last updated

Example: "2025-01-15T14:30:00Z"
paymentMethodTypestring(vendor-payment-methods_PaymentMethodType)required

How payment is made

Enum"ACH_WIRE""ZELLE""VENMO""ACH""CHECK""WIRE""CAD_EFT""TRIUMPH_PAY""COMCHECK""EFS"
statusstring or null

Payment method status

Example: "ACTIVE"
isPreferredboolean or null

Whether this is the preferred payment method for the vendor

Example: true
emailstring or null(email)

Email address for payment notifications

Example: "payments@vendor.com"
phonestring or null

Phone number for payment contact

Example: "+1-555-123-4567"
companyNamestring or null

Company name for this payment method (may differ from vendor name)

Example: "Vendor Payments LLC"
usernamestring or null

Username for payment platforms (e.g., Zelle, Venmo)

Example: "vendor_payments"
bankNamestring or null

Bank name

Example: "Chase Bank"
bankAddressstring or null

Bank address

Example: "123 Bank Street, Dallas, TX 75201"
accountNamestring or null

Bank account holder name

Example: "Vendor Services Inc"
accountNumberstring or null

Bank account number (masked in responses)

Example: "****1234"
abaAchstring or null

ABA/ACH routing number for electronic transfers

Example: "021000021"
wirestring or null

Wire transfer routing number

Example: "026009593"
swiftCodestring or null

SWIFT/BIC code for international transfers

Example: "CHASUS33"
eftInstitutionstring or null

EFT institution number (Canadian banking)

Example: "001"
eftTransitstring or null

EFT transit number (Canadian banking)

Example: "00010"
clabestring or null

CLABE number (Mexican banking identifier)

Example: "012180001234567897"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
paymentTermPaymentTermReference (object) or null

Payment terms for this payment method

Any of:

Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.

createdAtstring(date-time)read-onlyrequired

When the payment method was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)read-onlyrequired

When the payment method was last updated

Example: "2025-01-15T14:30:00Z"
deletedAtstring or null(date-time)read-only

When the payment method was soft deleted (null if active)

Example: null
deletedByUserReference (object) or nullread-only

User who deleted this payment method

Any of:

Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key.

Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.

Response
application/json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "vendorId": "770e8400-e29b-41d4-a716-446655440000",
  "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"
  },
  "paymentMethodType": "ACH",
  "status": "ACTIVE",
  "isPreferred": true,
  "email": "payments@vendor.com",
  "phone": "+1-555-123-4567",
  "companyName": "Vendor Payments LLC",
  "username": "vendor_payments",
  "bankName": "Chase Bank",
  "bankAddress": "123 Bank Street, Dallas, TX 75201",
  "accountName": "Vendor Services Inc",
  "accountNumber": "****1234",
  "abaAch": "021000021",
  "wire": "026009593",
  "swiftCode": "CHASUS33",
  "eftInstitution": "001",
  "eftTransit": "00010",
  "clabe": "012180001234567897",
  "currency": "USD",
  "paymentTerm": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-PAYTERM-NET30",
    "name": "Net 30",
    "description": "Payment due 30 days from invoice date",
    "days": 30,
    "quickPayFee": 0.05,
    "apOnly": false,
    "doNotUse": false,
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z",
    "deletedAt": null
  },
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z",
  "deletedAt": null,
  "deletedBy": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-USER-12345",
    "email": "john.doe@example.com",
    "name": "John Doe",
    "phone": "+1-555-123-4567",
    "phoneExt": "123",
    "status": "ACTIVE",
    "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z",
    "deletedAt": null
  }
}

Update vendor payment method

Request

Partially update a vendor payment method. Only provided fields will be updated.

IMPORTANT: The vendorId field cannot be changed after creation.

  • Omitted fields: Not modified (current value preserved)
  • Provided fields: Updated to the new value
  • Null values: Clear the field (set to null) where applicable
Security
BearerAuth
Path
idstringrequired

Resource ID (UUID) or client key

Example: 550e8400-e29b-41d4-a716-446655440000
Bodyapplication/jsonrequired
paymentMethodTypestring(vendor-payment-methods_PaymentMethodType)

How payment is made

Enum"ACH_WIRE""ZELLE""VENMO""ACH""CHECK""WIRE""CAD_EFT""TRIUMPH_PAY""COMCHECK""EFS"
statusstring or null

Payment method status

Example: "ACTIVE"
isPreferredboolean or null

Whether this is the preferred payment method

Example: true
emailstring or null(email)

Email address for payment notifications

Example: "payments@vendor.com"
phonestring or null

Phone number for payment contact

Example: "+1-555-123-4567"
companyNamestring or null

Company name for this payment method

Example: "Vendor Payments LLC"
usernamestring or null

Username for payment platforms

Example: "vendor_payments"
bankNamestring or null

Bank name

Example: "Chase Bank"
bankAddressstring or null

Bank address

Example: "123 Bank Street, Dallas, TX 75201"
accountNamestring or null

Bank account holder name

Example: "Vendor Services Inc"
accountNumberstring or null

Bank account number

Example: "1234567890"
abaAchstring or null

ABA/ACH routing number

Example: "021000021"
wirestring or null

Wire transfer routing number

Example: "026009593"
swiftCodestring or null

SWIFT/BIC code

Example: "CHASUS33"
eftInstitutionstring or null

EFT institution number

Example: "001"
eftTransitstring or null

EFT transit number

Example: "00010"
clabestring or null

CLABE number

Example: "012180001234567897"
currencystring or null

Preferred currency code

Example: "USD"
paymentTermIdstring or null(uuid)

Payment term ID

Example: "550e8400-e29b-41d4-a716-446655440002"
curl -i -X PATCH \
  https://api.mvmnt.io/v1/vendor-payment-methods/550e8400-e29b-41d4-a716-446655440000 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bankName": "Bank of America",
    "accountNumber": "9876543210",
    "abaAch": "026009593"
  }'

Responses

Vendor payment method updated successfully

Bodyapplication/json
idstring(uuid)read-onlyrequired

Unique vendor payment method identifier

Example: "550e8400-e29b-41d4-a716-446655440000"
vendorIdstring(uuid)read-onlyrequired

Vendor profile ID (read-only after creation).

This field cannot be changed after the payment method is created.

Example: "770e8400-e29b-41d4-a716-446655440000"
vendorobject(VendorReference)required

Vendor profile reference with full details

idstring(uuid)required

Vendor UUID

Example: "550e8400-e29b-41d4-a716-446655440000"
keystring or null<= 512 characters

Client-defined reference ID if set

Example: "ERP-VENDOR-ABC-001"
friendlyIdstringrequired

Human-readable vendor identifier

Example: "V123456"
namestringrequired

Vendor legal name

Example: "ABC Warehouse Services"
emailstring or null(email)

Primary email address

Example: "billing@abcwarehouse.com"
phonestring or null

Primary phone number

Example: "+1-555-123-4567"
statusstring or null

Vendor status

Example: "ACTIVE"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
createdAtstring(date-time)required

When the vendor was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)required

When the vendor was last updated

Example: "2025-01-15T14:30:00Z"
paymentMethodTypestring(vendor-payment-methods_PaymentMethodType)required

How payment is made

Enum"ACH_WIRE""ZELLE""VENMO""ACH""CHECK""WIRE""CAD_EFT""TRIUMPH_PAY""COMCHECK""EFS"
statusstring or null

Payment method status

Example: "ACTIVE"
isPreferredboolean or null

Whether this is the preferred payment method for the vendor

Example: true
emailstring or null(email)

Email address for payment notifications

Example: "payments@vendor.com"
phonestring or null

Phone number for payment contact

Example: "+1-555-123-4567"
companyNamestring or null

Company name for this payment method (may differ from vendor name)

Example: "Vendor Payments LLC"
usernamestring or null

Username for payment platforms (e.g., Zelle, Venmo)

Example: "vendor_payments"
bankNamestring or null

Bank name

Example: "Chase Bank"
bankAddressstring or null

Bank address

Example: "123 Bank Street, Dallas, TX 75201"
accountNamestring or null

Bank account holder name

Example: "Vendor Services Inc"
accountNumberstring or null

Bank account number (masked in responses)

Example: "****1234"
abaAchstring or null

ABA/ACH routing number for electronic transfers

Example: "021000021"
wirestring or null

Wire transfer routing number

Example: "026009593"
swiftCodestring or null

SWIFT/BIC code for international transfers

Example: "CHASUS33"
eftInstitutionstring or null

EFT institution number (Canadian banking)

Example: "001"
eftTransitstring or null

EFT transit number (Canadian banking)

Example: "00010"
clabestring or null

CLABE number (Mexican banking identifier)

Example: "012180001234567897"
currencystring or null

Preferred currency code (ISO 4217)

Example: "USD"
paymentTermPaymentTermReference (object) or null

Payment terms for this payment method

Any of:

Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.

createdAtstring(date-time)read-onlyrequired

When the payment method was created

Example: "2025-01-15T10:00:00Z"
updatedAtstring(date-time)read-onlyrequired

When the payment method was last updated

Example: "2025-01-15T14:30:00Z"
deletedAtstring or null(date-time)read-only

When the payment method was soft deleted (null if active)

Example: null
deletedByUserReference (object) or nullread-only

User who deleted this payment method

Any of:

Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key.

Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.

Response
application/json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "vendorId": "770e8400-e29b-41d4-a716-446655440000",
  "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"
  },
  "paymentMethodType": "ACH",
  "status": "ACTIVE",
  "isPreferred": true,
  "email": "payments@vendor.com",
  "phone": "+1-555-123-4567",
  "companyName": "Vendor Payments LLC",
  "username": "vendor_payments",
  "bankName": "Chase Bank",
  "bankAddress": "123 Bank Street, Dallas, TX 75201",
  "accountName": "Vendor Services Inc",
  "accountNumber": "****1234",
  "abaAch": "021000021",
  "wire": "026009593",
  "swiftCode": "CHASUS33",
  "eftInstitution": "001",
  "eftTransit": "00010",
  "clabe": "012180001234567897",
  "currency": "USD",
  "paymentTerm": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-PAYTERM-NET30",
    "name": "Net 30",
    "description": "Payment due 30 days from invoice date",
    "days": 30,
    "quickPayFee": 0.05,
    "apOnly": false,
    "doNotUse": false,
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z",
    "deletedAt": null
  },
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z",
  "deletedAt": null,
  "deletedBy": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-USER-12345",
    "email": "john.doe@example.com",
    "name": "John Doe",
    "phone": "+1-555-123-4567",
    "phoneExt": "123",
    "status": "ACTIVE",
    "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z",
    "deletedAt": null
  }
}

Delete vendor payment method

Request

Soft delete a vendor payment method (sets deletedAt timestamp).

The payment method will no longer appear in default queries but can be retrieved by explicitly filtering for deleted records.

Security
BearerAuth
Path
idstringrequired

Resource ID (UUID) or client key

Example: 550e8400-e29b-41d4-a716-446655440000
curl -i -X DELETE \
  https://api.mvmnt.io/v1/vendor-payment-methods/550e8400-e29b-41d4-a716-446655440000 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Vendor payment method deleted successfully

Response
No content

Event Notifications

Webhooks