updateMultiCurrencySubscriptionOffer()


Update different offers for different countries using localizedData array. Plase note, that you are unable to edit currency.

Parameters:

Name Type Description
publisherToken string You can find your publisher token at api-keys page.
multiCurrencyOfferId string E.g. if you create multicurrency offer and you get couple of ids: A767351455_FR, A767351455_US, A767351455_GB. multiCurrencyOfferId is just A767351455
offerData object No description
-price floatOffer price (in publisher's currency)
-period stringSubscription period: week / month / 3months / 6months / year
-title stringTitle of the offer, up to 70 chars.
-url stringUrl to content
-description stringAdditional offer description, up to 110 chars
-freePeriods intSet your free periods number
-freeDays intSet your free days number
-accessToTags arrayTo which tags customer has access. Multiple tags are defined as "OR" (not "AND"). Set "(all)" if you want to give access to all of your offers.
-countrystring2-letter country code
-currency stringChoose one: USD, EUR, GBP, CAD, AUD, NZD, SEK, DKK, NOK, TRL, ZAR, XOF
-price floatvalue between 0.14 and 99.99
-title stringTitle of the offer, up to 70 chars.
-url stringUrl to content
-description stringAdditional offer description, up to 110 chars
-geoRestrictionEnabled boolSet "true" to enable geo-restriction on this offer
-geoRestrictionType stringChoose type of geo-restriction: whitelist / blacklist
-geoRestrictionCountries arrayBased on geoRestrictionType, set the array of whitelisted/blacklisted countries.
localizedData array No description
-price floatOffer price (in publisher's currency)
-period stringSubscription period: week / month / 3months / 6months / year
-title stringTitle of the offer, up to 70 chars.
-url stringUrl to content
-description stringAdditional offer description, up to 110 chars
-freePeriods intSet your free periods number
-freeDays intSet your free days number
-accessToTags arrayTo which tags customer has access. Multiple tags are defined as "OR" (not "AND"). Set "(all)" if you want to give access to all of your offers.
-countrystring2-letter country code
-currency stringChoose one: USD, EUR, GBP, CAD, AUD, NZD, SEK, DKK, NOK, TRL, ZAR, XOF
-price floatvalue between 0.14 and 99.99
-title stringTitle of the offer, up to 70 chars.
-url stringUrl to content
-description stringAdditional offer description, up to 110 chars
-geoRestrictionEnabled boolSet "true" to enable geo-restriction on this offer
-geoRestrictionType stringChoose type of geo-restriction: whitelist / blacklist
-geoRestrictionCountries arrayBased on geoRestrictionType, set the array of whitelisted/blacklisted countries.

- required parameter


Request:

[
    {
        "method": "updateMultiCurrencySubscriptionOffer",
        "params": {
            "publisherToken": "klj_nerb324sPLhmzLtp4mDmdc8slwNNyALt-1Xn2Hy0Icfay",
            "multiCurrencyOfferId": "S740060915",
            "offerData": {
                "price": "10",
                "period": "year",
                "accessToTags": []
            },
            "localizedData": [
                {
                    "country": "US",
                    "currency": "USD",
                    "price": "11",
                    "title": "Test offer for US customers"
                },
                {
                    "country": "FR",
                    "currency": "EUR",
                    "price": "9"
                }
            ]
        },
        "jsonrpc": "2.0",
        "id": 1
    }
]

Response:

[
    {
        "result": {
            "multiCurrencyOfferId": "S740060915",
            "offers": [
                {
                    "id": "S740060915_FR",
                    "publisherEmail": "associate@email.com",
                    "title": "Test offer for French customers",
                    "description": "Test offer description",
                    "url": "http:\/\/testoffer.com\/fr",
                    "currency": "EUR",
                    "country": "FR",
                    "active": true,
                    "createdAt": 1384263564,
                    "updatedAt": 1384263564,
                    "price": 9,
                    "applicableTaxRate": "0.21",
                    "period": "year",
                    "expiresAt": null,
                    "accessToTags": []
                },
                {
                    "id": "S740060915_US",
                    "publisherEmail": "associate@email.com",
                    "title": "Test offer for US customers",
                    "description": "Test offer description",
                    "url": "http:\/\/www.testoffer.com",
                    "currency": "USD",
                    "country": "US",
                    "active": true,
                    "createdAt": 1384263564,
                    "updatedAt": 1384263564,
                    "price": 11,
                    "applicableTaxRate": "0.21",
                    "period": "year",
                    "expiresAt": null,
                    "accessToTags": []
                }
            ]
        },
        "id": "1",
        "error": null,
        "jsonrpc": "2.0"
    }
]

Remember! you can always check it by yourself using API Console - updateMultiCurrencySubscriptionOffer()

Back to Subscription Offers