# SubscriptionUpdatePreview

**credit**integer\<int32>required

Unused time that would be credited at the current price, in the smallest currency unit.

**Example:<!-- -->&#x20;**`500`

**charge**integer\<int32>required

Time that would be charged at the new price, in the smallest currency unit. An interval change charges the full new price rather than a fraction of it.

**Example:<!-- -->&#x20;**`1200`

**net**integer\<int32>required

The computed difference, `charge` minus `credit`. This is the amount that would move, except when `refundCapped` is true: a refund cannot exceed what the payment funding the current period received, so less than `net` would be refunded.

**Example:<!-- -->&#x20;**`700`

**direction**stringrequired

Whether the difference would be charged, refunded, or neither. `none` means the difference rounds to zero and no money moves.

**Possible values:** \[`charge`, `refund`, `none`]

**Example:<!-- -->&#x20;**`charge`

**refundCapped**booleanrequired

True when the refund would be smaller than the magnitude of `net`, because a refund cannot exceed the amount the payment funding the current period received.

**Example:<!-- -->&#x20;**`false`

**effectiveAt**integer\<int64>required

The date the change would take effect.

**Example:<!-- -->&#x20;**`1636366897`

**currentPeriodEnd**number\<int64>required

The end date of the current subscription period. Measured in seconds since the Unix epoch.

**Example:<!-- -->&#x20;**`1636366897`

**newPeriodEnd**integer\<int64>

The end of the billing period the change would start. Present only for an `interval` or `intervalCount` change, which restarts the period.

**Example:<!-- -->&#x20;**`1667902897`

**nextPaymentAt**integer\<int64>

When the next payment would be taken. Present only for an `interval` or `intervalCount` change.

**Example:<!-- -->&#x20;**`1667902897`

SubscriptionUpdatePreview

```
{

  "credit": 500,

  "charge": 1200,

  "net": 700,

  "direction": "charge",

  "refundCapped": false,

  "effectiveAt": 1636366897,

  "currentPeriodEnd": 1636366897,

  "newPeriodEnd": 1667902897,

  "nextPaymentAt": 1667902897

}
```
