Subscription Actions
Preview a server-authoritative next-order delay
Accepts contractId, optional billingAttemptId, and delayDays 7 or 14. Returns shop-local current and target dates without mutating. reasonCode is one of the SubscriptionActionReasonCode enum values.
POST
Preview a server-authoritative next-order delay
Body
application/json
Shopify subscription contract ID
Example:
123456789
Server-authoritative delay preset. Only 7 or 14 is accepted.
Available options:
7, 14 Example:
7
Exact upcoming billing attempt ID. Required by notification-originated callers.
Example:
987654321
Response
Eligibility result, including allowed, reasonCode, currentBillingDate, and targetBillingDate
Available options:
ALLOWED, EXECUTED, ALREADY_SKIPPED, ALREADY_RESCHEDULED, INVALID_REQUEST, INVALID_DELAY_DAYS, MISSING_IDEMPOTENCY_KEY, CONTRACT_NOT_FOUND, BILLING_ATTEMPT_NOT_FOUND, BILLING_ATTEMPT_CONTRACT_MISMATCH, NO_UPCOMING_ORDER, STALE_BILLING_ATTEMPT, QUICK_ACTIONS_NOT_ENABLED, INTEGRATIONS_NOT_ENABLED, TWO_WAY_SMS_NOT_ENABLED, PLAN_UPGRADE_REQUIRED, SKIP_NOT_ALLOWED, PREPAID_SKIP_NOT_SUPPORTED, RESCHEDULE_NOT_ALLOWED, MIN_CYCLES_NOT_COMPLETED, ATTRIBUTE_MIN_CYCLES_NOT_COMPLETED, TIME_WINDOW_RESTRICTED, ORDER_IN_PROGRESS, FIXED_BILLING_SCHEDULE, RESTRICTED_DATE, RESTRICTED_DAY_OF_WEEK, MUTATION_DECLINED, MUTATION_FAILED