# Configure merchant pricing

Use the [Merchant Pricing](https://app.gitbook.com/s/j9heLdoDRsfnChUQohvj/api/merchant-onboarding/onboard-merchant/pricing-plan) API to create or update pricing plans during merchant onboarding. This helps to configure the transaction fees, service charges, and other cost-related configurations that align with each merchant’s business needs.

**Customizable pricing plans**

Defines flexible pricing structures based on your business requirements. Each plan can include specific fee types, rates, and service charges.

**Transparent and competitive rates**

Configure pricing using predefined templates or customize plans to match individual merchant operations.

It supports both **POST** and **PUT** methods to manage merchant pricing efficiently and maintain transparent, business-aligned rate structures.

{% stepper %}
{% step %}
**Create pricing plan**

Use `POST` method with endpoint `/api/pricing/v2/PricingPlan/{merchantNumber}` to assign a new pricing plan to a merchant. Refer to the below request sample code for reference:

{% code lineNumbers="true" %}

```
{
  "pricingFees": [
    {
      "clearentPricingFeeID": 1,
      "pricingFeeDescription": "text",
      "rate": 1,
      "fee": 1,
      "payInMonth1": 1,
      "payInMonth2": 1
    }
  ],
  "pricingPlanID": 1,
  "pricingPlanTemplateID": 1,
  "merchantNumber": "text",
  "discountQualificationRangeID": 1,
  "signatureDebitDiscountQualificationRangeID": 1,
  "pricingTypeCode": "text",
  "isAdvancedPricing": true,
  "isEMF": true,
  "isDailySettle": true,
  "includeAssessments": true,
  "effectiveStartDateTimeUTC": "2025-09-08T08:21:53.300Z",
  "effectiveEndDateTimeUTC": "2025-09-08T08:21:53.300Z"
}
```

{% endcode %}

Refer to the below sample response code for reference:

{% code lineNumbers="true" %}

```json
{
  "pricingFees": [
    {
      "clearentPricingFeeID": 1,
      "pricingFeeDescription": "text",
      "rate": 1,
      "fee": 1,
      "payInMonth1": 1,
      "payInMonth2": 1
    }
  ],
  "pricingPlanID": 1,
  "pricingPlanTemplateID": 1,
  "merchantNumber": "text",
  "discountQualificationRangeID": 1,
  "signatureDebitDiscountQualificationRangeID": 1,
  "pricingTypeCode": "text",
  "isAdvancedPricing": true,
  "isEMF": true,
  "isDailySettle": true,
  "includeAssessments": true,
  "effectiveStartDateTimeUTC": "2025-09-08T08:21:53.300Z",
  "effectiveEndDateTimeUTC": "2025-09-08T08:21:53.300Z"
}
```

{% endcode %}
{% endstep %}

{% step %}
**Update pricing plan**

Use `PUT` method with endpoint `/api/pricing/v2/PricingPlan/{merchantNumber}/{id}` to modify an existing pricing plan assigned to a merchant. Refer to the below request sample code for reference:

{% code lineNumbers="true" fullWidth="true" %}

```json
{
  "pricingFees": [
    {
      "clearentPricingFeeID": 1,
      "pricingFeeDescription": "text",
      "rate": 1,
      "fee": 1,
      "payInMonth1": 1,
      "payInMonth2": 1
    }
  ],
  "pricingPlanID": 1,
  "pricingPlanTemplateID": 1,
  "merchantNumber": "text",
  "discountQualificationRangeID": 1,
  "signatureDebitDiscountQualificationRangeID": 1,
  "pricingTypeCode": "text",
  "isAdvancedPricing": true,
  "isEMF": true,
  "isDailySettle": true,
  "includeAssessments": true,
  "effectiveStartDateTimeUTC": "2025-09-08T08:21:53.300Z",
  "effectiveEndDateTimeUTC": "2025-09-08T08:21:53.300Z"
}
```

{% endcode %}

Refer to the below sample response code for reference:

{% code lineNumbers="true" %}

```json
{
  "pricingFees": [
    {
      "clearentPricingFeeID": 1,
      "pricingFeeDescription": "text",
      "rate": 1,
      "fee": 1,
      "payInMonth1": 1,
      "payInMonth2": 1
    }
  ],
  "pricingPlanID": 1,
  "pricingPlanTemplateID": 1,
  "merchantNumber": "text",
  "discountQualificationRangeID": 1,
  "signatureDebitDiscountQualificationRangeID": 1,
  "pricingTypeCode": "text",
  "isAdvancedPricing": true,
  "isEMF": true,
  "isDailySettle": true,
  "includeAssessments": true,
  "effectiveStartDateTimeUTC": "2025-09-08T08:21:53.300Z",
  "effectiveEndDateTimeUTC": "2025-09-08T08:21:53.300Z"
}
```

{% endcode %}
{% endstep %}
{% endstepper %}