Subscription Actions
Execute a server-authoritative next-order delay
Re-reads the recorded billing attempt, recomputes delayDays 7 or 14 in the shop IANA timezone, re-runs every eligibility guard, and returns a typed outcome. The client never supplies an authoritative target date.
POST
Execute 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
Typed result with outcome EXECUTED, ALREADY_APPLIED, DECLINED, STALE_CONTEXT, NOT_FOUND, or RETRYABLE_FAILURE and a SubscriptionActionReasonCode
Available options:
EXECUTED, ALREADY_APPLIED, DECLINED, STALE_CONTEXT, NOT_FOUND, RETRYABLE_FAILURE 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