Zinio

This guide walks you through integrating Zinio with Pelcro to sync digital magazine subscriptions automatically.

Overview

The Zinio integration relies on the invoice creation process to sync subscriptions into Zinio. When a new invoice is created — either from a new subscription or a renewal (auto-renew or manual) — Pelcro calls the Zinio API to create a corresponding subscription in Zinio. This works with both online and offline payment methods, and supports branded apps, newsstand subscriptions, or both.

Prerequisites:

1. Obtain your Zinio API keys from Zinio support
2. Provide the keys to the Pelcro support team or your account manager
3. Configure the "Zinio" entitlement on the appropriate plans (see Entitlements below)

Configuration

Contact your Zinio support team to retrieve the following Zinio API keys in order to provide them to the Pelcro team.

{
  "source_application_id": 12345,
  "source_project_id": 12345,
  "publication_id": 12345,
  "branded_app_project_id": 12345,
  "newsstand_project_id": 12345
}

Upon obtaining Zinio's API key, please provide it to Pelcro's support team or your account manager.

Entitlements

In order to provide your customers access to your Zinio application, you will need to enter "Zinio" as an entitlement in the plan configuration. This gives you the flexibility on a plan level to determine which customers should get access to Zinio.

API Samples

Request

{
  "project_id": 12345,
  "remote_identifier": "branded_app_12345",
  "source_application_id": 12345,
  "source_project_id": 12345,
  "items": [
    {
      "user_email": "[email protected]",
      "user_remote_identifier": 12345,
      "product_type": 2,
      "publication_id": 12345,
      "subscription_term_amount": 12,
      "subscription_term_units": "issues",
      "label_type": 12345,
      "allow_delivery_notification": 0,
      "customer_requested": 1
    }
  ]
}

Response

{
  "status": true,
  "data": {
    "id": 12345,
    "project_id": 12345,
    "directory_id": null,
    "remote_identifier": "branded_app_12345",
    "customer_requested": false,
    "audit_group": 0,
    "label_type": null,
    "allow_delivery_notification": 0,
    "account_id": null,
    "source_application_id": 12345,
    "source_project_id": 12345,
    "created_at": "2021-10-25T14:13:14+00:00"
  }
}