updateSubscriptionOffer

Update your subscription offer. Read more about all types of offers here. If property is omitted, it won't be updated.

📘

You can try that method by clicking here

Parameters

Name

Type

Description

publisherToken*

string

You can find your publisher token at api-keys page.

offerId*

string

Single offer identifier

offerData*

object

No description

-price*

float

Offer price (in publisher's currency), value between 0.14 and 99.99 in publishers currency. It will be taken from customer at a specific time period.

-period*

string

Subscription period: week / month / 3months / 6months / year.

-title*

string

Title of your subscription offer. Up to 70 chars

-url*

string

Url to your content described in the offer

-description*

string

Describe your subscription offer here. Up to 110 chars

-freePeriods*

int

Set your free periods number

-freeDays*

int

Set your free days number

-accessToTags*

array

To 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.

-geoRestrictionEnabled*

bool

Set "true" to enable geo-restriction on this offer

-geoRestrictionType*

string

Choose type of geo-restriction: whitelist / blacklist

-geoRestrictionCountries*

array

Based on geoRestrictionType, set the array of whitelisted/blacklisted countries.

API Request/Response

Request

{
  "method":"updateSubscriptionOffer",
  "params":{
    "publisherToken":"VNUNiFwbWJwJMD6aXbfqsTWouI8wbVKwQPh2ABnyb8dHnPtR",
    "offerId":"S580476507_US",
    "offerData":{
      "price":"75",
      "period":"week",
      "title":"not test anymorre",
      "url":"http:\/\/test.com\/page_with_content",
      "description":"my first update with Cleeng",
      "accessToTags":[
        ""
      ]
    }
  },
  "jsonrpc":"2.0",
  "id":1
}

Response

{
  "result":{
    "id":"S580476507_US",
    "publisherEmail":"[email protected]",
    "title":"not test anymorre",
    "description":"my first update with Cleeng",
    "url":"http:\/\/test.com\/page_with_content",
    "currency":"EUR",
    "country":"PL",
    "period":"week",
    "active":"1",
    "price":75,
    "createdAt":1353067309,
    "updatedAt":1353067309,
    "accessToTags":[
      ""
    ]
  },
  "id":"1",
  "error":null,
  "jsonrpc":"2.0"
}

PHP Example

<?php
    $offerId = 'S123123213_US';

    $offerSetup = array(
    'price' => 14.00,
    'description' => 'Christmas sale! Get access to every Bip Bip and Coyote episode for only 14$/month'
    );

    $cleengApi = new Cleeng_Api();
    $cleengApi->setPublisherToken('VIJYHWzJEP4mt1DZThD7DV_FinBG0Yo3Q9oHfCFAjqA22jXP');

    $cleengApi->updateSubscriptionOffer($offerId, $offerSetup);

?>