createSubscriptionOffer

Creates new subscription offer assigned to your publisher account. New offers inherit your currency and country.
Read more about all types of offers here.

📘

You can try that method by cliking here

Parameters

NameTypeDescription
publisherToken*stringYou can find your publisher token at api-keys page.
offerData*objectNo description
-pricefloatOffer price (in publisher's currency). It will be taken from customer at a specific time period.
-periodstringSubscription period: week / month / 3months / 6months / year.
-titlestringTitle of your subscription offer. Up to 70 chars
-urlstringUrl to your content described in the offer
-description*stringDescribe your subscription offer here. 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.
-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.

API Request/Response

Request

{
  "method":"createSubscriptionOffer",
  "params":{
    "publisherToken":"VNUNiFwbWJwJMD6aXbfqsTWouI8wbVKwQPh2ABnyb8dHnPtR",
    "offerData":{
      "price":"25",
      "period":"week",
      "title":"test",
      "url":"http:\/\/test.com\/page_with_content",
      "description":"my first offer with Cleeng",
      "accessToTags":[

      ]
    }
  },
  "jsonrpc":"2.0",
  "id":1
}

Response

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

PHP Example

<?php
    $offerSetup = array(
    'title' => 'Bip Bip and Coyote cartoon',
    'price' => 19.00,
    'url' => 'http://your-site.com/watch/bipbip/',
    'description' => 'Get access to every Bip Bip and Coyote episode for 19$/month',
    'period' => 'month',
    'accessToTags' => array('Bip Bip and Coyote')
    );

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

    $cleengApi->createSubscriptionOffer($offerSetup);

?>