プラン変更のプレビュー

POST

subscriptions

{subscription_id}

change-plan

preview

JavaScript

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const response = await client.subscriptions.previewChangePlan('sub_Iuaq622bbmmfOGrVTqdXv', {
  product_id: 'product_id',
  proration_billing_mode: 'prorated_immediately',
  quantity: 0,
});

console.log(response.immediate_charge);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
response = client.subscriptions.preview_change_plan(
    subscription_id="sub_Iuaq622bbmmfOGrVTqdXv",
    product_id="product_id",
    proration_billing_mode="prorated_immediately",
    quantity=0,
)
print(response.immediate_charge)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	response, err := client.Subscriptions.PreviewChangePlan(
		context.TODO(),
		"sub_Iuaq622bbmmfOGrVTqdXv",
		dodopayments.SubscriptionPreviewChangePlanParams{
			UpdateSubscriptionPlanReq: dodopayments.UpdateSubscriptionPlanReqParam{
				ProductID:            dodopayments.F("product_id"),
				ProrationBillingMode: dodopayments.F(dodopayments.UpdateSubscriptionPlanReqProrationBillingModeProratedImmediately),
				Quantity:             dodopayments.F(int64(0)),
			},
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.ImmediateCharge)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanParams;
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanResponse;
import com.dodopayments.api.models.subscriptions.UpdateSubscriptionPlanReq;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        SubscriptionPreviewChangePlanParams params = SubscriptionPreviewChangePlanParams.builder()
            .subscriptionId("sub_Iuaq622bbmmfOGrVTqdXv")
            .updateSubscriptionPlanReq(UpdateSubscriptionPlanReq.builder()
                .productId("product_id")
                .prorationBillingMode(UpdateSubscriptionPlanReq.ProrationBillingMode.PRORATED_IMMEDIATELY)
                .quantity(0)
                .build())
            .build();
        SubscriptionPreviewChangePlanResponse response = client.subscriptions().previewChangePlan(params);
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanParams
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanResponse
import com.dodopayments.api.models.subscriptions.UpdateSubscriptionPlanReq

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val params: SubscriptionPreviewChangePlanParams = SubscriptionPreviewChangePlanParams.builder()
        .subscriptionId("sub_Iuaq622bbmmfOGrVTqdXv")
        .updateSubscriptionPlanReq(UpdateSubscriptionPlanReq.builder()
            .productId("product_id")
            .prorationBillingMode(UpdateSubscriptionPlanReq.ProrationBillingMode.PRORATED_IMMEDIATELY)
            .quantity(0)
            .build())
        .build()
    val response: SubscriptionPreviewChangePlanResponse = client.subscriptions().previewChangePlan(params)
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

response = dodo_payments.subscriptions.preview_change_plan(
  "sub_Iuaq622bbmmfOGrVTqdXv",
  product_id: "product_id",
  proration_billing_mode: :prorated_immediately,
  quantity: 0
)

puts(response)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $response = $client->subscriptions->previewChangePlan(
    'sub_Iuaq622bbmmfOGrVTqdXv',
    productID: 'product_id',
    prorationBillingMode: 'prorated_immediately',
    quantity: 0,
    adaptiveCurrencyFeesInclusive: true,
    addons: [['addonID' => 'addon_id', 'quantity' => 0]],
    cancelOlderPaymentLink: true,
    cancelScheduledChangePlan: true,
    collectViaPaymentLink: true,
    discountCode: 'discount_code',
    discountCodes: ['string'],
    effectiveAt: 'immediately',
    metadata: ['foo' => 'string'],
    onPaymentFailure: 'prevent_change',
    returnURL: 'return_url',
  );

  var_dump($response);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Subscriptions;

DodoPaymentsClient client = new();

SubscriptionPreviewChangePlanParams parameters = new()
{
    SubscriptionID = "sub_Iuaq622bbmmfOGrVTqdXv",
    ProductID = "product_id",
    ProrationBillingMode = SubscriptionPreviewChangePlanParamsProrationBillingMode.ProratedImmediately,
    Quantity = 0,
};

var response = await client.Subscriptions.PreviewChangePlan(parameters);

Console.WriteLine(response);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let subscription_id = "subscription_id";
    let result = client
        .subscriptions()
        .preview_change_plan()
        .subscription_id(subscription_id)
        .body(dodopayments::models::SubscriptionsChangePlanParams {
                product_id: Some("product_id".to_string()),
                proration_billing_mode: Some("prorated_immediately".to_string()),
                quantity: Some(0),
                ..Default::default()
            })
        .await?;
    println!("{result:?}");
    Ok(())
}

curl --request POST \
  --url https://test.dodopayments.com/subscriptions/{subscription_id}/change-plan/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product_id": "<string>",
  "quantity": 1,
  "adaptive_currency_fees_inclusive": true,
  "addons": [
    {
      "addon_id": "<string>",
      "quantity": 1
    }
  ],
  "cancel_older_payment_link": true,
  "cancel_scheduled_change_plan": true,
  "collect_via_payment_link": true,
  "discount_code": "<string>",
  "discount_codes": [
    "<string>"
  ],
  "metadata": {},
  "return_url": "<string>"
}
'

{
  "immediate_charge": {
    "effective_at": "2023-11-07T05:31:56Z",
    "line_items": [
      {
        "currency": "AED",
        "id": "<string>",
        "product_id": "<string>",
        "proration_factor": 123,
        "quantity": 123,
        "tax_inclusive": true,
        "type": "subscription",
        "unit_price": 123,
        "description": "<string>",
        "name": "<string>",
        "tax": 123,
        "tax_rate": 123
      }
    ],
    "summary": {
      "currency": "AED",
      "customer_credits": 123,
      "customer_credits_currency": "AED",
      "settlement_amount": 123,
      "settlement_currency": "AED",
      "total_amount": 123,
      "settlement_tax": 123,
      "tax": 123
    }
  },
  "new_plan": {
    "addons": [
      {
        "addon_id": "<string>",
        "quantity": 123
      }
    ],
    "billing": {
      "country": "AF",
      "city": "<string>",
      "state": "<string>",
      "street": "<string>",
      "zipcode": "<string>"
    },
    "brand_id": "<string>",
    "cancel_at_next_billing_date": true,
    "created_at": "2023-11-07T05:31:56Z",
    "credit_entitlement_cart": [
      {
        "credit_entitlement_id": "<string>",
        "credit_entitlement_name": "<string>",
        "credits_amount": "<string>",
        "overage_balance": "<string>",
        "overage_behavior": "forgive_at_reset",
        "overage_enabled": true,
        "product_id": "<string>",
        "remaining_balance": "<string>",
        "rollover_enabled": true,
        "unit": "<string>",
        "expires_after_days": 123,
        "low_balance_threshold_percent": 123,
        "max_rollover_count": 123,
        "overage_limit": "<string>",
        "rollover_percentage": 123,
        "rollover_timeframe_count": 123,
        "rollover_timeframe_interval": "Day"
      }
    ],
    "currency": "AED",
    "customer": {
      "customer_id": "<string>",
      "email": "<string>",
      "name": "<string>",
      "metadata": {},
      "phone_number": "<string>"
    },
    "has_payment_method": true,
    "metadata": {},
    "meter_credit_entitlement_cart": [
      {
        "credit_entitlement_id": "<string>",
        "meter_id": "<string>",
        "meter_name": "<string>",
        "meter_units_per_credit": "<string>",
        "product_id": "<string>"
      }
    ],
    "meters": [
      {
        "currency": "AED",
        "free_threshold": 123,
        "measurement_unit": "<string>",
        "meter_id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "price_per_unit": "10.50"
      }
    ],
    "next_billing_date": "2023-11-07T05:31:56Z",
    "on_demand": true,
    "payment_frequency_count": 123,
    "payment_frequency_interval": "Day",
    "previous_billing_date": "2023-11-07T05:31:56Z",
    "product_id": "<string>",
    "quantity": 123,
    "recurring_pre_tax_amount": 123,
    "status": "pending",
    "subscription_id": "<string>",
    "subscription_period_count": 123,
    "subscription_period_interval": "Day",
    "tax_inclusive": true,
    "trial_period_days": 123,
    "cancellation_comment": "<string>",
    "cancellation_feedback": "too_expensive",
    "cancelled_at": "2023-11-07T05:31:56Z",
    "cancelled_by": {
      "actor_type": "customer",
      "email": "<string>",
      "name": "<string>"
    },
    "custom_field_responses": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "customer_business_name": "<string>",
    "discount_cycles_remaining": 123,
    "discount_id": "<string>",
    "discounts": [
      {
        "amount": 123,
        "business_id": "<string>",
        "code": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "discount_id": "<string>",
        "metadata": {},
        "position": 123,
        "preserve_on_plan_change": true,
        "restricted_to": [
          "<string>"
        ],
        "times_used": 123,
        "type": "flat",
        "cycles_remaining": 123,
        "expires_at": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "subscription_cycles": 123,
        "usage_limit": 123
      }
    ],
    "expires_at": "2023-11-07T05:31:56Z",
    "paused_at": "2023-11-07T05:31:56Z",
    "payment_method_id": "<string>",
    "scheduled_change": {
      "addons": [
        {
          "addon_id": "<string>",
          "name": "<string>",
          "quantity": 123
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "effective_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "product_id": "<string>",
      "quantity": 123,
      "product_description": "<string>",
      "product_name": "<string>"
    },
    "tax_id": "<string>",
    "trial_amount": 123
  }
}

このエンドポイントを使用して、サブスクリプションのアップグレードやダウングレード時に顧客に正確な料金を示します。これにより透明性が向上し、サポートへの問い合わせを減らすことができます。

ユースケース

チェックアウト確認: 顧客がプラン変更を確認する前に比例配分された料金を表示
料金計算機: アプリケーションでアップグレード/ダウングレード計算機を構築
顧客セルフサービス: 顧客が正確な価格でプランオプションを探求できるように
割引検証: 重ね合わせた割引コードがプラン変更の価格にどのように影響するかをプレビュー

変更を確定する前に、スタックされた割引が即時の請求および新しいプランの価格にどのように影響するかを見るために、プレビューリクエストで discount_codes （20個までのコードの配列、順番に適用）を含めることができます。単一の discount_code フィールドは廃止予定ですが、後方互換性のためにまだサポートされています。今後は discount_codes をお勧めします。

レスポンスフィールド

プレビュー応答には次のものが含まれます：

フィールド	説明
`immediate_charge`	行項目とサマリーを含め、即時に作成される料金
`new_plan`	プラン変更後の状態を示す完全なサブスクリプションオブジェクト

immediate_charge.summaryは請求される合計金額を含みます。顧客がプラン変更を確認する前に価格を表示するために使用してください。

承認

Authorization

string

header

必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

パスパラメータ

subscription_id

string

必須

Subscription Id

ボディ

application/json

product_id

string

必須

Unique identifier of the product to subscribe to

proration_billing_mode

enum<string>

必須

Proration Billing Mode

利用可能なオプション:

prorated_immediately,

full_immediately,

difference_immediately,

do_not_bill,

prorated_immediately_keep_cycle

quantity

integer<int32>

必須

Number of units to subscribe for. Must be at least 1.

必須範囲: x >= 0

adaptive_currency_fees_inclusive

boolean | null

Whether adaptive currency fees should be included in the price (true) or added on top (false). If not specified, uses the subscription's stored setting.

addons

Attach Addon Request · object[] | null

Addons for the new plan. Note : Leaving this empty would remove any existing addons

Show child attributes

cancel_older_payment_link

boolean

Cancel the payment link of a pending plan change, so that this change can replace it.

The link is cancelled only if the customer has not started to pay. A paid or in-progress payment gives a 409. A failed cancel gives a 503, and a retry is safe.

The request is validated before the cancel. A later failure, for example an amount below the minimum, leaves the subscription on its current plan with no open link. A retry is safe.

The preview route shares this request body and ignores this field.

cancel_scheduled_change_plan

boolean

Replace a scheduled plan change with this one.

The scheduled change is cancelled by the transaction that applies this change. A change that never applies leaves the schedule in place.

effective_at: next_billing_date is allowed. The new schedule then replaces the old one in the request transaction.

A pending plan change still gets a 409. This field does not affect it.

The preview route shares this request body, so a preview that sets this field also passes the scheduled-change 409.

collect_via_payment_link

boolean

Collect the plan-change amount with a payment link. The customer then pays on a checkout page.

The business needs the allow_plan_change_via_payment_link capability. The request needs effective_at: immediately. The request also needs on_payment_failure: prevent_change.

The preview route shares this request body and ignores this field.

discount_code

string | null

非推奨

DEPRECATED: Use discount_codes instead. Cannot be used together with discount_codes.

discount_codes

string[] | null

Stacked discount codes to apply to the new plan. Max 20. Cannot be used together with discount_code. If provided, replaces any existing discount codes. Empty array removes all discounts. If not provided (None), existing discounts with preserve_on_plan_change=true are preserved.

effective_at

enum<string>

When to apply the plan change.

immediately (default): Apply the plan change right away
next_billing_date: Schedule the change for the next billing date

利用可能なオプション:

immediately,

next_billing_date

metadata

null | Metadata · object

Metadata for the payment. If not passed, the metadata of the subscription will be taken

Show child attributes

on_payment_failure

null | enum<string>

Controls behavior when the plan change payment fails.

prevent_change: Keep subscription on current plan until payment succeeds
apply_change (default): Apply plan change immediately regardless of payment outcome

With effective_at: next_billing_date, the plan change payment replaces the renewal payment. If that payment fails with prevent_change, the plan change is cancelled. The subscription then renews on the current plan, with the usual payment retries.

If not specified, uses the business-level default setting.

利用可能なオプション:

prevent_change,

apply_change

return_url

string | null

The URL that receives the customer after they pay the payment link. Needs collect_via_payment_link: true. Without it, the request gets a 422. A change that collects no money issues no link and does not use the URL. The preview route validates this field but does not use it.

The redirect adds subscription_id, payment_id and status. The status value is the status of the plan-change payment. It is not the status of the subscription. When that payment fails, the subscription stays active on its current plan. To try again, call this endpoint again to get a new link. The new plan can apply after the redirect, when the payment webhook arrives.

レスポンス

Preview of subscription plan change

immediate_charge

object

必須

Show child attributes

new_plan

object

必須

Response struct representing subscription details

Show child attributes

最終更新日 2026年5月22日

JavaScript

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const response = await client.subscriptions.previewChangePlan('sub_Iuaq622bbmmfOGrVTqdXv', {
  product_id: 'product_id',
  proration_billing_mode: 'prorated_immediately',
  quantity: 0,
});

console.log(response.immediate_charge);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
response = client.subscriptions.preview_change_plan(
    subscription_id="sub_Iuaq622bbmmfOGrVTqdXv",
    product_id="product_id",
    proration_billing_mode="prorated_immediately",
    quantity=0,
)
print(response.immediate_charge)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	response, err := client.Subscriptions.PreviewChangePlan(
		context.TODO(),
		"sub_Iuaq622bbmmfOGrVTqdXv",
		dodopayments.SubscriptionPreviewChangePlanParams{
			UpdateSubscriptionPlanReq: dodopayments.UpdateSubscriptionPlanReqParam{
				ProductID:            dodopayments.F("product_id"),
				ProrationBillingMode: dodopayments.F(dodopayments.UpdateSubscriptionPlanReqProrationBillingModeProratedImmediately),
				Quantity:             dodopayments.F(int64(0)),
			},
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.ImmediateCharge)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanParams;
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanResponse;
import com.dodopayments.api.models.subscriptions.UpdateSubscriptionPlanReq;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        SubscriptionPreviewChangePlanParams params = SubscriptionPreviewChangePlanParams.builder()
            .subscriptionId("sub_Iuaq622bbmmfOGrVTqdXv")
            .updateSubscriptionPlanReq(UpdateSubscriptionPlanReq.builder()
                .productId("product_id")
                .prorationBillingMode(UpdateSubscriptionPlanReq.ProrationBillingMode.PRORATED_IMMEDIATELY)
                .quantity(0)
                .build())
            .build();
        SubscriptionPreviewChangePlanResponse response = client.subscriptions().previewChangePlan(params);
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanParams
import com.dodopayments.api.models.subscriptions.SubscriptionPreviewChangePlanResponse
import com.dodopayments.api.models.subscriptions.UpdateSubscriptionPlanReq

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val params: SubscriptionPreviewChangePlanParams = SubscriptionPreviewChangePlanParams.builder()
        .subscriptionId("sub_Iuaq622bbmmfOGrVTqdXv")
        .updateSubscriptionPlanReq(UpdateSubscriptionPlanReq.builder()
            .productId("product_id")
            .prorationBillingMode(UpdateSubscriptionPlanReq.ProrationBillingMode.PRORATED_IMMEDIATELY)
            .quantity(0)
            .build())
        .build()
    val response: SubscriptionPreviewChangePlanResponse = client.subscriptions().previewChangePlan(params)
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

response = dodo_payments.subscriptions.preview_change_plan(
  "sub_Iuaq622bbmmfOGrVTqdXv",
  product_id: "product_id",
  proration_billing_mode: :prorated_immediately,
  quantity: 0
)

puts(response)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $response = $client->subscriptions->previewChangePlan(
    'sub_Iuaq622bbmmfOGrVTqdXv',
    productID: 'product_id',
    prorationBillingMode: 'prorated_immediately',
    quantity: 0,
    adaptiveCurrencyFeesInclusive: true,
    addons: [['addonID' => 'addon_id', 'quantity' => 0]],
    cancelOlderPaymentLink: true,
    cancelScheduledChangePlan: true,
    collectViaPaymentLink: true,
    discountCode: 'discount_code',
    discountCodes: ['string'],
    effectiveAt: 'immediately',
    metadata: ['foo' => 'string'],
    onPaymentFailure: 'prevent_change',
    returnURL: 'return_url',
  );

  var_dump($response);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Subscriptions;

DodoPaymentsClient client = new();

SubscriptionPreviewChangePlanParams parameters = new()
{
    SubscriptionID = "sub_Iuaq622bbmmfOGrVTqdXv",
    ProductID = "product_id",
    ProrationBillingMode = SubscriptionPreviewChangePlanParamsProrationBillingMode.ProratedImmediately,
    Quantity = 0,
};

var response = await client.Subscriptions.PreviewChangePlan(parameters);

Console.WriteLine(response);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let subscription_id = "subscription_id";
    let result = client
        .subscriptions()
        .preview_change_plan()
        .subscription_id(subscription_id)
        .body(dodopayments::models::SubscriptionsChangePlanParams {
                product_id: Some("product_id".to_string()),
                proration_billing_mode: Some("prorated_immediately".to_string()),
                quantity: Some(0),
                ..Default::default()
            })
        .await?;
    println!("{result:?}");
    Ok(())
}

curl --request POST \
  --url https://test.dodopayments.com/subscriptions/{subscription_id}/change-plan/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product_id": "<string>",
  "quantity": 1,
  "adaptive_currency_fees_inclusive": true,
  "addons": [
    {
      "addon_id": "<string>",
      "quantity": 1
    }
  ],
  "cancel_older_payment_link": true,
  "cancel_scheduled_change_plan": true,
  "collect_via_payment_link": true,
  "discount_code": "<string>",
  "discount_codes": [
    "<string>"
  ],
  "metadata": {},
  "return_url": "<string>"
}
'

{
  "immediate_charge": {
    "effective_at": "2023-11-07T05:31:56Z",
    "line_items": [
      {
        "currency": "AED",
        "id": "<string>",
        "product_id": "<string>",
        "proration_factor": 123,
        "quantity": 123,
        "tax_inclusive": true,
        "type": "subscription",
        "unit_price": 123,
        "description": "<string>",
        "name": "<string>",
        "tax": 123,
        "tax_rate": 123
      }
    ],
    "summary": {
      "currency": "AED",
      "customer_credits": 123,
      "customer_credits_currency": "AED",
      "settlement_amount": 123,
      "settlement_currency": "AED",
      "total_amount": 123,
      "settlement_tax": 123,
      "tax": 123
    }
  },
  "new_plan": {
    "addons": [
      {
        "addon_id": "<string>",
        "quantity": 123
      }
    ],
    "billing": {
      "country": "AF",
      "city": "<string>",
      "state": "<string>",
      "street": "<string>",
      "zipcode": "<string>"
    },
    "brand_id": "<string>",
    "cancel_at_next_billing_date": true,
    "created_at": "2023-11-07T05:31:56Z",
    "credit_entitlement_cart": [
      {
        "credit_entitlement_id": "<string>",
        "credit_entitlement_name": "<string>",
        "credits_amount": "<string>",
        "overage_balance": "<string>",
        "overage_behavior": "forgive_at_reset",
        "overage_enabled": true,
        "product_id": "<string>",
        "remaining_balance": "<string>",
        "rollover_enabled": true,
        "unit": "<string>",
        "expires_after_days": 123,
        "low_balance_threshold_percent": 123,
        "max_rollover_count": 123,
        "overage_limit": "<string>",
        "rollover_percentage": 123,
        "rollover_timeframe_count": 123,
        "rollover_timeframe_interval": "Day"
      }
    ],
    "currency": "AED",
    "customer": {
      "customer_id": "<string>",
      "email": "<string>",
      "name": "<string>",
      "metadata": {},
      "phone_number": "<string>"
    },
    "has_payment_method": true,
    "metadata": {},
    "meter_credit_entitlement_cart": [
      {
        "credit_entitlement_id": "<string>",
        "meter_id": "<string>",
        "meter_name": "<string>",
        "meter_units_per_credit": "<string>",
        "product_id": "<string>"
      }
    ],
    "meters": [
      {
        "currency": "AED",
        "free_threshold": 123,
        "measurement_unit": "<string>",
        "meter_id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "price_per_unit": "10.50"
      }
    ],
    "next_billing_date": "2023-11-07T05:31:56Z",
    "on_demand": true,
    "payment_frequency_count": 123,
    "payment_frequency_interval": "Day",
    "previous_billing_date": "2023-11-07T05:31:56Z",
    "product_id": "<string>",
    "quantity": 123,
    "recurring_pre_tax_amount": 123,
    "status": "pending",
    "subscription_id": "<string>",
    "subscription_period_count": 123,
    "subscription_period_interval": "Day",
    "tax_inclusive": true,
    "trial_period_days": 123,
    "cancellation_comment": "<string>",
    "cancellation_feedback": "too_expensive",
    "cancelled_at": "2023-11-07T05:31:56Z",
    "cancelled_by": {
      "actor_type": "customer",
      "email": "<string>",
      "name": "<string>"
    },
    "custom_field_responses": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "customer_business_name": "<string>",
    "discount_cycles_remaining": 123,
    "discount_id": "<string>",
    "discounts": [
      {
        "amount": 123,
        "business_id": "<string>",
        "code": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "discount_id": "<string>",
        "metadata": {},
        "position": 123,
        "preserve_on_plan_change": true,
        "restricted_to": [
          "<string>"
        ],
        "times_used": 123,
        "type": "flat",
        "cycles_remaining": 123,
        "expires_at": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "subscription_cycles": 123,
        "usage_limit": 123
      }
    ],
    "expires_at": "2023-11-07T05:31:56Z",
    "paused_at": "2023-11-07T05:31:56Z",
    "payment_method_id": "<string>",
    "scheduled_change": {
      "addons": [
        {
          "addon_id": "<string>",
          "name": "<string>",
          "quantity": 123
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "effective_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "product_id": "<string>",
      "quantity": 123,
      "product_description": "<string>",
      "product_name": "<string>"
    },
    "tax_id": "<string>",
    "trial_amount": 123
  }
}

API Reference

Checkout Sessions

Payments

Subscriptions

Discounts

Licenses

Entitlements

Customers

Customer Wallets

Products

Localized Pricing

Addons

Credit Entitlements

Meters

Usage Events

Refunds

Disputes

Payouts

Balance Ledger

Moderation

Brands

Webhooks

Miscellaneous

Product Collections

ユースケース

レスポンスフィールド

承認

パスパラメータ

ボディ

レスポンス

​ユースケース

​レスポンスフィールド

承認

パスパラメータ

ボディ

レスポンス

ユースケース

レスポンスフィールド