---
title: "Create marketplace creditor operations"
method: POST
path: "/v2/marketplaces/{marketplaceId}/creditors-operations"
tags: ["Marketplace creditor operations"]
---

# Create marketplace creditor operations

`POST /v2/marketplaces/{marketplaceId}/creditors-operations`

## Request

- Base URL: `https://sandbox.pismolabs.io/marketplace`
- URL: `https://sandbox.pismolabs.io/marketplace/v2/marketplaces/{marketplaceId}/creditors-operations`
- Auth: HTTP bearer

Create multiple creditor operations for the specified marketplace.

This endpoint creates one creditor operation for each merchant ID and each installment in the request body. The values of `processing_code` and `start_date` are replicated to each creditor operation created based on the installments configuration.

This endpoint generates [Marketplace creditor operation created](https://developers.pismo.io/events/docs/marketplace-marketplace-creditor-operation-created-1) events.

## Path parameters

- `marketplaceId` integer, required

## Headers

- `Authorization` string

## Request body

- PostCreditorOperationV2
  - `merchant_ids` integer[], required: List of merchants that this creditor operation applies to
  - `creditor_operation` object, required: Creditor operation information
    - `processing_code` string, required: A processing code is a custom alphanumeric identifier that defines the type of financial operation that the Pismo platform handles.<br> For more information, refer to [Processing codes](doc:processing-codes-and-transaction-types).
    - `start_date` string, date, required: Date from which this operation is considered active. Format = yyyy-mm-dd.
    - `installments` object[], required: Configuration for each installment
      - `installment` number, required: Installment number
      - `first_installment_days_to_payment` integer: Number of days before first installment is due
      - `n_installment_days_to_payment` integer: Number of days before each subsequent installment is due. The customer has `first_installment_days_to_payment` days to pay the first installment. They have `n_installment_days_to_payment` days to pay each installment after that.
      - `transaction_fee` number: Transaction fee
      - `mdr` number, float: MDR fee. The Merchant Discount Rate (MDR) is the rate charged to a merchant for payment processing services on debit and credit card transactions. The merchant must set up this service and agree to the rate before accepting debit and credit cards as payment.
      - `matched_mdr` boolean: Indicates whether this is a matched Merchant Discount Rate (MDR). If `false`, the fixed transaction fee and the MDR amount is applied only to the first installment. The default value is `false`.
      - `matched_settlement` boolean: Indicates whether this is a matched settlement. A matched settlement means the settlement is paid in several batches, whereas `false` indicates the full amount is paid in one single payment. The default value is `false`.
      - `work_days` boolean: If `true`, only business days are used to calculate the date of the next payment.
      - `fees` Fee[]: Creditor operation additional fees
        - `name` string, required: Fee model name
        - `value` number, float, required: Fee value; Dependent on the fee model. Usually a percentage (for example, `0.05` for 5%) or fixed amount (for example, `1.5` for a fixed fee of 1.5 currency units).

## Response `201`

Created

## Other responses

- `400`: Bad Request
- `401`: Access token is missing or invalid
- `409`: Conflict. One or more submitted creditor operations already exist for the specified merchants.
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/seller-management-marketplace.md) - [All operations](https://skmtc.dev/pismo/apis/seller-management-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/seller-management-marketplace/revisions/b138e2d42e1a?raw)