Sets the subscription for an in progress subscription order

This endpoint cannot be used for an in progress subscription order with subscription order Action equal to subscription order action Reactivate

Licenses Required

Vista.Ocapi
Vista.Subscriptions

Request

path Parameters

orderId

required

string

The unique identifier of the in progress subscription order being modified

header Parameters

loyaltySessionToken	string Current Loyalty session token, represents a 'signed-in' member
Connect-Region-Code	string Region Code

Request Body schema:
application/json
required

The requested subscription

subscriptionBillingOptionId required	string non-empty Gets the unique identifier of the subscription billing option
discountId	string or null Gets the unique identifier of the discount used, if applicable
voucherId	string or null Gets the unique identifier of the order voucher used, if applicable

Responses

200

Success

400

Request property is invalid or missing, or invalid order type.

401

No member authenticated.

404

Order does not exist.

put/ocapi/v1/orders/{orderId}/subscription

Request samples

Payload
curl
JavaScript
Node.js

{"subscriptionBillingOptionId": "string",
"discountId": "string",
"voucherId": "string"
}

Response samples

application/json

{"order": {"id": "string",
"type": "Standard",
"status": "InProgress",
"totalPrice": {"valueIncludingTax": 0.1,
"valueExcludingTax": 0.1,
"tax": 0.1
},
"vouchers": [{"id": "string",
"type": "Ticket",
"maskedBarcode": "12.......6789",
"voucherTypeCode": "string",
"voucherTypeDescription": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"deals": [{"id": "string",
"dealId": "string",
"voucherId": "string"
}
],
"payments": [{"id": "string",
"type": "CinemaProcessed",
"value": 0.1,
"status": "NotStarted"
}
],
"subscription": {"subscriptionBillingOptionId": "string",
"price": {"valueIncludingTax": 0.1,
"valueExcludingTax": 0.1,
"tax": 0.1
},
"subscriptionId": 0,
"discountId": "string",
"voucherId": "string"
},
"action": "Purchase",
"expiresAt": "2019-08-24T14:15:22Z",
"hasCustomer": true,
"amountSaved": {"valueIncludingTax": 0.1,
"valueExcludingTax": 0.1,
"tax": 0.1
}
},
"relatedData": {"films": [{"id": "string",
"title": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"externalIds": {"moviexchangeReleaseId": "6ce6697a-16c1-46a9-acef-0a6ce948a353",
"corporateId": "string"
},
"censorRatingId": "string",
"censorRatingNote": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"ticketTypes": [{"id": "string",
"description": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"items": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"hoCode": "string",
"hopk": "string",
"isSundry": true,
"isPreparationRequired": true
}
],
"showtimes": [{"id": "string",
"schedule": {"businessDate": "2019-08-24T14:15:22Z",
"startsAt": "2019-08-24T14:15:22Z",
"endsAt": "2019-08-24T14:15:22Z",
"filmStartsAt": "2019-08-24T14:15:22Z",
"filmEndsAt": "2019-08-24T14:15:22Z",
"inSeatItemDelivery": {"startsAt": "2019-08-24T14:15:22Z",
"endsAt": "2019-08-24T14:15:22Z"
}
},
"filmId": "string",
"siteId": "string",
"screenId": "string"
}
],
"sites": [{"location": {"latitude": 0.1,
"longitude": 0.1
},
"contactDetails": {"phoneNumbers": [{"type": "Home",
"number": "string"
}
],
"email": "string",
"address": {"line1": "60 Khyber Pass Road",
"line2": "Grafton",
"city": "Auckland 1023"
}
},
"ianaTimeZoneName": "America/New_York",
"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"hasSellableItems": true,
"allowedItemDeliveryMethods": ["CounterPickup"
]
}
],
"screens": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"censorRatings": [{"id": "string",
"classification": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"classificationDescription": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"ageRestriction": {"minimumAge": 0
}
}
],
"itemServiceAreas": [{"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"shortName": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"itemShowtimeDeliveryWindows": [{"minutes": 0,
"type": "MinutesFromStart",
"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
}
],
"subscriptionBillingOption": {"id": "string",
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"subscriptionId": 0,
"billingPeriodInMonths": 0,
"isRecurring": true
},
"subscription": {"id": 0,
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
}
},
"balanceType": {"id": 0,
"name": {"text": "string",
"translations": [{"languageTag": "en-US",
"text": "string"
}
]
},
"isPrimary": true,
"unitName": "Points",
"paymentConversionRate": 0.1,
"unitDecimalPlaces": 0
}
}
}

Sets the subscription for an in progress subscription order

Licenses Required

path Parameters

header Parameters

Request Body schema: application/jsontext/jsonapplication/*+jsonapplication/json-patch+jsonapplication/jsonrequired

Request Body schema:
application/json
required