asc subscriptions pricing
Manage subscription pricing across all 175 App Store territories.
Overview
The pricing commands help you:
- View current subscription prices
- Set prices using Apple's price equalization
- Configure per-territory pricing
- Preview changes before applying
Commands
list
List current pricing for a subscription.
asc subscriptions pricing list <subscription-id>
Arguments:
subscription-id- The subscription's App Store Connect ID or product ID
Options:
| Option | Short | Description |
|---|---|---|
--output | -o | Output format: table, json, yaml |
--territory | -t | Filter to specific territory |
Example:
asc subscriptions pricing list live.yooz.whisper.pro.monthly
Output:
Territory Currency Price Price Point
USA USD $2.99 60
GBR GBP £2.49 60
DEU EUR €2.99 60
JPN JPY ¥400 60
...
set
Set pricing for a subscription.
asc subscriptions pricing set <subscription-id> --price <usd-amount>
Arguments:
subscription-id- The subscription's App Store Connect ID
Options:
| Option | Short | Description | Default |
|---|---|---|---|
--price | -p | Base price in USD | Required |
--equalize | Use price equalization | true | |
--no-equalize | Disable equalization | ||
--territory | -t | Specific territory (repeatable) | All |
--dry-run | Preview without applying | false |
Examples:
Set $2.99 for all territories:
asc subscriptions pricing set SUB_ID --price 2.99
Preview changes first:
asc subscriptions pricing set SUB_ID --price 2.99 --dry-run
Set for specific territories only:
asc subscriptions pricing set SUB_ID --price 2.99 -t USA -t CAN -t GBR
Price Equalization
How It Works
Apple provides 175 territories with different currencies. Price equalization:
- You specify a USD price (e.g., $2.99)
- CLI finds the matching Apple price point in USA
- Apple's API returns equivalent prices for all territories
- CLI creates subscription prices for each territory
Price Points
Apple uses a fixed set of price points. Your requested price maps to the nearest point:
| USD Price | Price Point | EUR | GBP | JPY |
|---|---|---|---|---|
| $0.99 | 10 | €0.99 | £0.79 | ¥160 |
| $1.99 | 30 | €1.99 | £1.49 | ¥300 |
| $2.99 | 60 | €2.99 | £2.49 | ¥400 |
| $4.99 | 80 | €4.99 | £4.49 | ¥700 |
| $9.99 | 130 | €9.99 | £8.99 | ¥1,300 |
Finding Price Points
Run asc subscriptions pricing points to list all available price points.
Disable Equalization
For custom per-territory pricing:
asc subscriptions pricing set SUB_ID --price 2.99 --no-equalize -t USA
asc subscriptions pricing set SUB_ID --price 2.49 --no-equalize -t GBR
Territory Codes
Use ISO 3166-1 alpha-3 codes:
| Code | Country |
|---|---|
| USA | United States |
| GBR | United Kingdom |
| DEU | Germany |
| FRA | France |
| JPN | Japan |
| AUS | Australia |
| CAN | Canada |
| CHN | China |
| ... | (175 total) |
List all territories:
asc subscriptions pricing territories
Workflow Examples
Standard Pricing Setup
# 1. List subscriptions to find ID
asc subscriptions list live.yooz.whisper
# 2. Preview pricing
asc subscriptions pricing set SUB_ID --price 2.99 --dry-run
# 3. Apply pricing
asc subscriptions pricing set SUB_ID --price 2.99
# 4. Verify
asc subscriptions pricing list SUB_ID
Regional Pricing Strategy
# Higher price for US/UK/EU
asc subscriptions pricing set SUB_ID --price 4.99 -t USA -t GBR -t DEU -t FRA
# Lower price for emerging markets
asc subscriptions pricing set SUB_ID --price 1.99 -t IND -t BRA -t IDN
Updating Existing Prices
# Check current
asc subscriptions pricing list SUB_ID
# Update
asc subscriptions pricing set SUB_ID --price 3.99 --dry-run
asc subscriptions pricing set SUB_ID --price 3.99
Dry-Run Output
asc subscriptions pricing set SUB_ID --price 2.99 --dry-run
DRY RUN - No changes will be made
Subscription: live.yooz.whisper.pro.monthly
Base Price: $2.99 (Price Point 60)
Territory Prices (175 total):
USA: $2.99 (unchanged)
GBR: £2.49 (was £1.99)
DEU: €2.99 (unchanged)
JPN: ¥400 (was ¥350)
...
Summary:
Unchanged: 120 territories
Updated: 55 territories
New: 0 territories
Run without --dry-run to apply changes.
Error Handling
Invalid Price
Error: Price $2.50 does not match any Apple price point.
Nearest options:
$2.49 (Price Point 57)
$2.99 (Price Point 60)
Subscription Not Found
Error: Subscription not found: invalid.product.id
Available subscriptions for live.yooz.whisper:
live.yooz.whisper.pro.monthly
live.yooz.whisper.pro.yearly
Rate Limiting
Error: Rate limited by App Store Connect.
Processed 50 territories.
Resume with: asc subscriptions pricing set SUB_ID --price 2.99 --skip 50
Best Practices
- Always dry-run first - Preview changes before applying
- Use equalization - Apple handles currency conversion properly
- Regional strategies - Consider purchasing power parity
- Document changes - Keep pricing history for reference
- Use YAML for multiple - Bulk config for multiple subscriptions