Card Isle Widget

Easily offer Card Isle cards within your Ecommerce platform.


Bring your customers access to Card Isle's collection of over 9,000 greeting card designs and the ability to upload personal photos. Simply drop in a few lines of code to your website, and install a plug-and-play printer at your distribution facility.



Your card:



Your message:

Artist signature:

Embedded Widget Documentation

Our goal is to make this easy

If you have any questions, please don't hesitate to reach out to info@cardisle.com.


The simplest web integration

This will get you the absolute minimum code necessary to start selling personalized greeting cards from your store.

<button type="button" class="card-isle-button">DEMO: Click me</button>
<script src="https://s3.amazonaws.com/cardisle.web/static/ecommerce/shop_embed.js"></script>
<script">
  $(document).ready(function() {
    initiate_card_isle_widget();
  });
</script>


The first line provides us with an HTML hook where we can add all of our iframe functionality. The card-isle-button class gives you the flexibility to customize any styling on the button element. And the last lines initiate the widget.


Want to get fancy? Add a listener.

After a customer designs a card, we'll post a message back to you with the details of that card in JSON format.

RESPONSE PARAMETERS:
  status: "success" or "failure"
  card_image: url to a thumbnail of the card cover art
  card_text: peronalized message from inside of card
  artist_signature: signature of artist who created the cover art

EXAMPLE RESPONSE:
{
  "status": "success",
  "card_image": "https://urltoimage.jpg",
  "card_text": "Happy Earth Day!",
  "artist_signature": "Lyonel Feininger"
}

Below is an example of how you could implement a pure JS listener:

<script>
window.addEventListener("message", receiveMessage, false);
function receiveMessage(event) {
  // verify that message came from Card Isle
  if (event.origin !== "https://cardisle.com")
    return;
  // print JSON data to console
  console.log("JSON data from Card Isle", event.data);}
</script>


And printing the cards is easy

We'll work with you to install a printer in your distribution center. All that we need for the printer is an electrical outlet and an ethernet connection. Cards are printed on-demand by a simple API POST.

POST ENDPOINT: https://cardisle.com/api/embed/print

POST AUTHENTICATION: Basic access authentication (username and password provided by Card Isle)

POST PARAMETERS:
  cardisle_parnter_id: the same cardisle_parnter_id as was used when the card was designed
  cardisle_session_id: the same cardisle_session_id as was used when the card was designed

EXAMPLE POST:
{
  "cardisle_parnter_id": "abcdefgh",
  "cardisle_session_id": "1234567890"
}

RESPONSE PARAMETERS:
  status: "success" or "failure"
  message: if there is a failure, this will give a brief description of why

EXAMPLE RESPONSE:
{
  "status": "success",
  "message": "None"
}


Card Examples

Want to learn more?