# Update subscription by merchant product id

Endpoint: PATCH /subscription
Version: 1.2
Security: X-Api-Key

## Header parameters:

  - `X-Idempotency-Key` (string)
    The system supports the query deduplication mechanism. 
Any system-wide merchant's request after the first one with 
the same  will return an error.
For example, if you have retrying mechanism for payouts and you want 
to avoid double sending, you can put header with value payout_{your_payout_id}

## Query parameters:

  - `merchant_product_id` (string, required)
    Example: "2JZGULPNK27K2"

## Request fields (application/json):

  - `is_rebill_enabled` (boolean, required)

## Response 200 fields (application/json):

  - `type` (string)
    Enum: "SUBSCRIPTION"

  - `data` (object)

  - `data.version` (integer)

  - `data.initial_transaction_id` (string)

  - `data.subscription_id` (string)

  - `data.created_at` (string)
    UTC date time format

  - `data.subscription_status` (string)

  - `data.expires_at` (string)
    UTC date time format

  - `data.merchant_id` (string)

  - `data.merchant_product_id` (string)

  - `data.merchant_payment_id` (string)

  - `data.merchant_customer_id` (string)

  - `data.payment_method` (string)
    Enum: "CARD"

  - `data.currency_code` (string)

  - `data.amount` (string)

  - `data.transaction_currency_code` (string)

  - `data.transaction_amount` (string)

  - `data.transaction_fee_currency_code` (string)

  - `data.transaction_fee_amount` (string)

  - `data.transaction_tax_currency_code` (string)

  - `data.transaction_tax_amount` (string)

  - `data.transaction_tax_type` (string)

  - `data.transaction_tax_label` (string)

  - `data.transaction_tax_percentage` (string)

  - `data.is_trial` (boolean)

  - `data.charge_interval` (string)
    Enum: "DAY"

  - `data.charge_interval_value` (number)

  - `data.is_rebill_enabled` (boolean)

  - `data.trial_interval` (string)
    Enum: "DAY"

  - `data.trial_interval_value` (number)

  - `data.payment_id` (string)
    Example: "2JWZGTNKS67K2"

  - `data.product_id` (string)
    Example: "2JWZGTNKSG7K2"

  - `data.retry_at` (string)
    UTC date time format

  - `data.retry_count` (number)

  - `data.retry_total_count` (number)
    Total count of attempts to rebill

  - `data.shop_name` (string)
    Shop name from original payment

  - `data.shop_url` (string)
    Shop URL from original payment

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)

## Response 500 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)