Skip an upcoming billing order
Skips the next scheduled billing/order for a membership contract. The membership remains active, but the next billing date is moved to the following cycle.
Key Features:
- Skip next billing without canceling membership
- Automatically reschedule to next billing cycle
- Works for both regular and prepaid memberships
- Activity logging for audit trail
How It Works:
- Validates billing attempt exists and belongs to shop
- Updates next billing date to skip current cycle
- Moves billing to the next scheduled interval
- Logs activity (customer portal vs merchant portal)
Customer Portal Restrictions:
- Cannot skip if membership is frozen until min cycles
- Validates contract ownership for security
Use Cases:
- Customer is traveling and wants to skip one delivery
- Customer has excess inventory and wants to pause one cycle
- Merchant wants to skip a billing due to out-of-stock items
- Skip billing for special circumstances (holidays, etc.)
Prepaid Handling:
- Set
isPrepaid=truefor prepaid memberships - Different validation logic for prepaid vs pay-as-you-go
Authentication: Requires authenticated shop user or customer portal token
Path Parameters
Billing attempt ID to skip
Query Parameters
Optional subscription contract ID for additional validation
Set to true if this is a prepaid membership
Response
Billing order successfully skipped
Shop domain identifier
"my-store.myshopify.com"
Number of billing retry attempts
1
Shopify billing attempt ID
Scheduled billing date for this attempt
Associated subscription contract ID
67890
Unique identifier of the billing attempt record
12345
Total order amount
29.99
Shopify order ID if billing was successful
Shopify order name/number
"#1001"
Order note or special instructions
SENT, UNSENT, FAILED, EMAIL_SETTINGS_DISABLED, CONTRACT_CANCELLED Current status of the billing attempt
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 SENT, UNSENT, FAILED, EMAIL_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED SENT, UNSENT, FAILED, SMS_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED, PHONE_NUMBER_EMPTY SENT, UNSENT, FAILED, EMAIL_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED, STOP_FROM_CONTRACT, CONTRACT_PAUSED SENT, UNSENT, FAILED, SMS_SETTINGS_DISABLED, CUSTOMER_PAYMENT_EMPTY, CONTRACT_CANCELLED, STOP_FROM_CONTRACT, CONTRACT_PAUSED, PHONE_NUMBER_EMPTY SUCCESS, FAILED, TO_BE_TRIED