# Billing & Orders

APIs for managing membership billing attempts, recurring orders, payment retries, order history, and order skipping

## Skip an upcoming billing order

 - [PUT /memberships/cp/api/subscription-billing-attempts/skip-order/{id}](https://developers.membership.appstle.com/storefront-api-swagger/billing-and-orders/skiporder.md): 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:
1. Validates billing attempt exists and belongs to shop
2. Updates next billing date to skip current cycle
3. Moves billing to the next scheduled interval
4. 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=true for prepaid memberships
- Different validation logic for prepaid vs pay-as-you-go

Authentication: Requires authenticated shop user or customer portal token

## attemptBilling

 - [PUT /memberships/cp/api/subscription-billing-attempts/attempt-billing/{id}](https://developers.membership.appstle.com/storefront-api-swagger/billing-and-orders/attemptbilling.md)

## updateSubscriptionBillingAttempt

 - [PUT /memberships/cp/api/subscription-billing-attempts](https://developers.membership.appstle.com/storefront-api-swagger/billing-and-orders/updatesubscriptionbillingattempt.md)

## getTopOrdersForCP

 - [GET /memberships/cp/api/subscription-billing-attempts/top-orders](https://developers.membership.appstle.com/storefront-api-swagger/billing-and-orders/gettopordersforcp.md)

## getPastOrdersForCP

 - [GET /memberships/cp/api/subscription-billing-attempts/past-orders](https://developers.membership.appstle.com/storefront-api-swagger/billing-and-orders/getpastordersforcp.md)