Syntax

listUpgrades()

Lists the upgrades that you have created in Digistore24

Access rights

Read access required.

Parameters

(none)

Returns

 Array
(
    [data] => Array
        (
            [upgrades] => Array
                (
                    [0] => Array
                        (
                            [upgrade_url] => https://www.digistore24.com/upgrade/123-aBcDeFgH1234/ORDER_ID
                            [id] => 123
                            [name] => Some Upgrade Name
                            [to_product_id] => 654
                            [is_active] => Y
                            [authkey] => aBcDeFgH1234
                            [fallback_product_id] => 876
                            [buyer_readonly_keys] => none
                            [upgrade_types] => Array
                                (
                                    [112] => upgrade
                                    [113] => downgrade
                                    [114] => special_offer
                                )

                        )

                    [1] => Array
                        (
                            [upgrade_url] => https://www.digistore24.com/upgrade/234-aBcDeFgH1234/ORDER_ID
                            [id] => 234
                            [name] => Some other upgrade
                            [to_product_id] => 987
                            [is_active] => Y
                            [authkey] => aBcDeFgH1234
                            [fallback_product_id] =>
                            [buyer_readonly_keys] => none
                            [upgrade_types] => Array
                                (
                                 [112] => upgrade
                                 [113] => downgrade
                                 [114] => special_offer
                                )
                        )
                )
        )
) 

Carry out an upgrade

In order to carry out an upgrade, direct the member to the upgrade URL. Replace the placeholder ORDER_ID in the upgrade_url with the member's Digistore order IDs (separated by commas). For example:

https://www.digistore24.com/upgrade/234-aBcDeFgH1234/ABCD1234,BCDE2345,CDEF3456

Upgrade types

The available upgrade types depend on the product purchased.

This is defined in the database by upgrade_types. Here, the upgrade type is specified for each product that may be purchased.

For example, a member offer (special_offer) exists if the member had purchased product 112 in the existing order.

Possible upgrade types are:

• Member offer (special_offer): The existing order remains unchanged.

• Upgrade (upgrade): The payments of the existing order are terminated. The new tariff applies immediately. The remaining credit from the existing order will be offset against the new order. The new order becomes active immediately.

• Downgrade (downgrade): The payments of the existing order are terminated. The new order will become active at the beginning of the next billing period.