Upgrade Subscription To Prepaid

PATCH

https://restapi.ordergroove.com/subscriptions/:subscription_id/upgrade_to_prepaid/

PATCH

/subscriptions/:subscription_id/upgrade_to_prepaid/

curl -X PATCH https://restapi.ordergroove.com/subscriptions/subscription_id/upgrade_to_prepaid/ \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "orders_per_billing": 1
}'

{
  "customer": "{customer_id}",
  "merchant": "{merchant_id",
  "product": "{product_id}",
  "payment": "{payment_id}",
  "shipping_address": "{shipping_address_id}",
  "offer": "{offer_id}",
  "subscription_type": "replenishment",
  "raw_subscription_type": "replenishment",
  "components": [],
  "extra_data": {
    "shopify_contract_id": "gid://shopify/SubscriptionContract/{shopify_contract_id}"
  },
  "public_id": "{public_id}",
  "quantity": 1,
  "frequency_days": 30,
  "reminder_days": 4,
  "every": 1,
  "every_period": 3,
  "start_date": "2023-05-30",
  "session_id": "{session_id}",
  "merchant_order_id": "#1144",
  "created": "2023-05-30 13:20:41",
  "updated": "2023-10-03 10:22:11",
  "live": true,
  "external_id": "{external_id",
  "queued_actions": [],
  "prepaid_subscription_context": {
    "prepaid_orders_remaining": 4,
    "prepaid_orders_per_billing": 6,
    "renewal_behavior": "autorenew"
  }
}

This endpoint will allow you to upgrade a pay-as-you-go subscription to a prepaid subscription

Authentication

x-api-keystring

API Key authentication via header

Path parameters

subscription_idstringRequired

Unique subscription ID

Request

This endpoint expects an object.

orders_per_billingintegerRequired

An integer greater than 2

renewal_behaviorenumOptionalDefaults to autorenew

Allowed values:

offerstringOptionalDefaults to live

An optional field that if populated will switch which offer the subscription is associated with after upgrade. You can provide the public-id of the offer that you would like to swap the subscription to, or the string “live” which will re-associate the subscription with your currently live offer

Response

200

customerstringOptional

merchantstringOptional

productstringOptional

paymentstringOptional

shipping_addressstringOptional

offerstringOptional

subscription_typestringOptional

raw_subscription_typestringOptional

componentslist of objectsOptional

extra_dataobjectOptional

public_idstringOptional

quantityintegerOptionalDefaults to 0

pricedouble or nullOptional

frequency_daysintegerOptionalDefaults to 0

reminder_daysintegerOptionalDefaults to 0

everyintegerOptionalDefaults to 0

every_periodintegerOptionalDefaults to 0

start_datestringOptional

cancelledboolean or nullOptional

cancel_reasonstring or nullOptional

iterationdouble or nullOptional

sequencedouble or nullOptional

session_idstringOptional

merchant_order_idstringOptional

createdstringOptional

updatedstringOptional

livebooleanOptionalDefaults to true

external_idstringOptional

product_attributemap from strings to any or nullOptional

cancel_reason_codestring or nullOptional

customer_repmap from strings to any or nullOptional

clubmap from strings to any or nullOptional

queued_actionslist of objectsOptional

prepaid_subscription_contextobjectOptional

Errors

400

Bad Request Error