Change History

  • Pub/sub notifications for subscriptions and purchase orders now include a sequenceNumber attribute.

  • Standalone, one-time subscriptions can be created and will automatically cancel at the next renewal.

  • A new line_item_index field has been added to Subscription.LineItem and PurchaseOrder.PurchaseOrderLineItem.

  • The Create API will return a 409 HTTP code instead of ERROR_CODE_SUBSCRIPTION_IN_REQUESTED_STATE when a subscription is already created and activated.

Upcoming Changes

Rollout Complete

  • a new sequenceNumber attribute in subscription and purchase order pubsub notifications.

    • 100% rollout: 06/29/2023.

  • Supports creating a standalone subscription that will be charged once. The subscription will have a line item of LINE_ITEM_RECURRENCE_TYPE_ONE_TIME. It will be automatically cancelled at the next subscription renewal.

    • 100% rollout: 07/13/2023.

  • A new field line_item_index in Subscription.LineItem, and PurchaseOrder.PurchaseOrderLineItem.

    • 100% rollout: 07/21/2023.

  • We are proposing to return 409 http code for Create API when subscription is already created by the partner and is activated. We currently return ERROR_CODE_SUBSCRIPTION_IN_REQUESTED_STATE error code for this scenario.

    • 100% rollout: 09/03/2024.
    • Sample new error message below:
{
  "error": {
    "code": 409,
    "message": "The subscription is already in the requested state",
    ...
  }
}