Skip upcoming subscription order

Skips a scheduled billing attempt, preventing the order from being processed. The next billing date is automatically recalculated based on the subscription frequency.

Full behavior, validation rules, and side effects

Key Features:

• Flexible Skipping: Skip any upcoming order
• Auto-Rescheduling: Next billing date automatically adjusted
• Prepaid Support: Handles both regular and prepaid subscriptions
• Activity Logging: Tracks skip events for reporting
• Customer Control: Allow members to manage delivery timing

How It Works:

1. Marks the billing attempt as skipped
2. Calculates new next billing date (current date + frequency)
3. Updates subscription contract in Shopify
4. Logs skip activity with event source
5. Returns updated billing attempt details

Use Cases:

• Customer going on vacation
• Too much inventory on hand
• Temporary pause without canceling
• Budget constraints for specific month
• Customize delivery schedule

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

PUT /api/external/v2/subscription-billing-attempts/skip-order/{id}

Skip upcoming subscription order

cURL

curl --request PUT \
  --url https://membership-admin.appstle.com/api/external/v2/subscription-billing-attempts/skip-order/{id}

200

{
  "shop": "my-store.myshopify.com",
  "retryingNeeded": true,
  "id": 12345,
  "billingAttemptId": "<string>",
  "billingDate": "2023-11-07T05:31:56Z",
  "contractId": 67890,
  "attemptCount": 1,
  "attemptTime": "2023-11-07T05:31:56Z",
  "graphOrderId": "<string>",
  "orderId": 123,
  "orderAmount": 29.99,
  "orderName": "#1001",
  "applyUsageCharge": true,
  "recurringChargeId": 123,
  "transactionRate": 123,
  "billingAttemptResponseMessage": "<string>",
  "progressAttemptCount": 123,
  "orderNote": "<string>",
  "variantList": [
    {
      "variantId": 123,
      "quantity": 123,
      "title": "<string>",
      "image": "<string>",
      "productTitle": "<string>",
      "productId": "<string>",
      "sellingPlanId": "<string>"
    }
  ],
  "orderAmountUSD": 123,
  "upgradeDowngradeBilling": true
}

Headers

X-API-Key · string

Path Parameters

id · integer<int64> · required

Billing attempt ID to skip

Query Parameters

api_key · string

API Key (Deprecated - Use Header X-API-Key instead)

subscriptionContractId · integer<int64>

Subscription contract ID

isPrepaid · boolean · default: false

Whether this is a prepaid subscription

Response

200

application/json

Order successfully skipped, returns updated billing attempt

shop · string · required

Shop domain identifier

Example:

"my-store.myshopify.com"

retryingNeeded · boolean · required

id · integer<int64>

Unique identifier of the billing attempt record

Example:

12345

billingAttemptId · string

Shopify billing attempt ID

status · enum<string>

Current status of the billing attempt

Available options: SUCCESS, FAILURE, REQUESTING, PROGRESS, QUEUED, SKIPPED, SOCIAL_CONNECTION_NULL, CONTRACT_CANCELLED, CONTRACT_ENDED, CONTRACT_PAUSED, AUTO_CHARGE_DISABLED, SKIPPED_DUNNING_MGMT, SECURITY_CHALLENGE, SHOPIFY_EXCEPTION

billingDate · string<date-time>

Scheduled billing date for this attempt

contractId · integer<int64>

Associated subscription contract ID

Example:

67890

attemptCount · integer<int32>

Number of billing retry attempts

Example:

1

attemptTime · string<date-time>

graphOrderId · string

orderId · integer<int64>

Shopify order ID if billing was successful

orderAmount · number<double>

Total order amount

Example:

29.99

orderName · string

Shopify order name/number

Example:

"#1001"

transactionFailedEmailSentStatus · enum<string>

Available options: SENT, UNSENT, FAILED, EMAIL_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED

upcomingOrderEmailSentStatus · enum<string>

Available options: SENT, UNSENT, FAILED, EMAIL_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED, STOP_FROM_CONTRACT, CONTRACT_PAUSED

applyUsageCharge · boolean

recurringChargeId · integer<int64>

transactionRate · number<double>

usageChargeStatus · enum<string>

Available options: SUCCESS, FAILED, TO_BE_TRIED

transactionFailedSmsSentStatus · enum<string>

Available options: SENT, UNSENT, FAILED, SMS_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED, PHONE_NUMBER_EMPTY

upcomingOrderSmsSentStatus · enum<string>

Available options: SENT, UNSENT, FAILED, SMS_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED, STOP_FROM_CONTRACT, CONTRACT_PAUSED, PHONE_NUMBER_EMPTY

billingAttemptResponseMessage · string

progressAttemptCount · integer<int32>

orderNote · string

Order note or special instructions

variantList · object[]

Show child attributes

orderAmountUSD · number<double>

securityChallengeSentStatus · enum<string>

Available options: SENT, UNSENT, FAILED, EMAIL_SETTINGS_DISABLED, CONTRACT_CANCELLED

upgradeDowngradeBilling · boolean