# Carrier Payment Methods

## Filter carrier payment methods

 - [POST /carrier-payment-methods/filter](https://docs.mvmnt.io/apis/openapi/carrier-payment-methods/filtercarrierpaymentmethods.md): Query carrier 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.

Carrier payment methods define how and where payments are sent for a specific carrier.

## Create carrier payment method

 - [POST /carrier-payment-methods](https://docs.mvmnt.io/apis/openapi/carrier-payment-methods/createcarrierpaymentmethod.md): Create a new carrier payment method.

Payment Recipient Type Constraints:
- DIRECT: Payment goes to carrier directly. carrierFactorId must be null or omitted.
- FACTOR: Payment goes to factoring company. carrierFactorId is required.

Important: The carrierId cannot be changed after creation.

## Get carrier payment method

 - [GET /carrier-payment-methods/{id}](https://docs.mvmnt.io/apis/openapi/carrier-payment-methods/getcarrierpaymentmethodbyid.md): Retrieve a single carrier payment method by its unique identifier.

Returns full details including banking information and associated carrier/factor references.

## Update carrier payment method

 - [PATCH /carrier-payment-methods/{id}](https://docs.mvmnt.io/apis/openapi/carrier-payment-methods/updatecarrierpaymentmethod.md): Partially update a carrier payment method. Only provided fields will be updated.

IMPORTANT: The carrierId field cannot be changed after creation.

Payment Recipient Type Constraints:
- When changing to DIRECT: carrierFactorId must be set to null
- When changing to FACTOR: carrierFactorId is required

- Omitted fields: Not modified (current value preserved)
- Provided fields: Updated to the new value
- Null values: Clear the field (set to null) where applicable

## Delete carrier payment method

 - [DELETE /carrier-payment-methods/{id}](https://docs.mvmnt.io/apis/openapi/carrier-payment-methods/deletecarrierpaymentmethod.md): Soft delete a carrier 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.