Update membership contract status

Supported Status Values:

• ACTIVE: Membership is active and will process recurring billing
• PAUSED: Membership is temporarily paused, no billing will occur
• CANCELLED: Membership is permanently cancelled, no future billing
• EXPIRED: Membership has expired (typically used when max cycles reached)

Pause Duration:

• When pausing, you can optionally specify pauseDurationCycle to auto-resume after N cycles
• If not specified, membership remains paused until manually reactivated

Business Rules & Validations:

• Customer Portal Restrictions: When called from customer portal, additional validations apply:
  • Cannot modify frozen memberships (freeze till min cycle condition)
  • Must respect billing cycle limits configured by merchant
• Contract Validation: System validates that the contract belongs to the authenticated shop
• Activity Logging: All status changes are logged with source (merchant portal vs customer portal)

Use Cases:

• Customer wants to pause their membership temporarily
• Merchant needs to cancel a membership due to customer request
• Reactivating a paused membership
• Marking membership as expired when max cycles reached

Authentication: Requires authenticated shop user or customer portal token