PARTNERINTEGRATION MED CR80

Ditt varumärke. Ditt arbetsflöde.

Bädda in editorn på din webbplats, ta emot en versionshanterad design och behåll kundrelationen och din egen kassa. CR80 hanterar kortets geometri, rendering och validering inför produktion.

1. När din ansökan har godkänts öppnar du partnerportalen och loggar in med den verifierade e-postadressen från ansökan. Aktivera din inbjudan där.
2. Öppna partnerinställningarna. Ange ditt varumärke, exakt vilka HTTPS-origins som är tillåtna och ditt sortiment av fysiska kort. Varje material och teknik har ett separat artikelnummer (SKU).
3. Använd det partner-ID som visas i inställningarna i exemplen nedan. Lägg aldrig licensnycklar, API-hemligheter eller kunders inloggningstoken i iframe-adresser eller webbläsarkod.
4. Börja med fiktiva namn och bilder. Godkännandet ger tillgång till kostnadsfria tester och startar ingen debitering. Förhandsvisningar i testläget märks med PROVPERIOD och produktions-API:erna blockerar riktiga produktionsfiler.

Bädda in editorn

Lägg till webbplatsens origin i partnerinställningarna, inklusive protokoll och eventuell port som avviker från standard. Sidan som bäddar in editorn måste matcha en godkänd origin. Använd HTTPS i produktion.

<iframe id="cr80-editor"
  src="https://cr80.se/editor?partner=YOUR_PARTNER_ID&embed=1"
  title="Card editor"
  style="width:100%;height:760px;border:0"
></iframe>

Partnern väljer varumärke, sortiment och tillgängliga funktioner. Inbäddningen ger ingen åtkomst till konton. CR80-konton och partnerns kundkonton är fortsatt separata.

Ta emot en design säkert

Kontrollera exakt origin, iframe-fönster, partner-ID och meddelandetyp. Testmeddelanden skiljer sig avsiktligt från produktionsmeddelanden. Exemplet fångar upp en färdig design, men skapar ingen beställning.

const frame = document.getElementById("cr80-editor");
const partnerId = "YOUR_PARTNER_ID";
window.addEventListener("message", (event) => {
  if (event.origin !== "https://cr80.se") return;
  if (event.source !== frame.contentWindow) return;
  const message = event.data;
  if (!message || message.partner !== partnerId) return;
  if (message.type === "cr80-test-design" && message.test === true) {
    // Display a test result. Never submit to your order or print queue.
    document.getElementById("result").textContent = "Test design received";
    return;
  }
  if (message.type !== "cr80-design" || message.test !== false) return;
  // Production integration: authenticate the customer on YOUR server,
  // validate the versioned design and SKU, calculate your own price,
  // and require explicit order confirmation. A message is not an order.
});

Skapa ett resultatelement på sidan: <p id="result" role="status"></p>. Lägg till felhantering för din applikation och validering på servern innan du använder detta i kassan. Lita aldrig på data från webbläsaren utan att validera den.

API:er och designkontraktet

Designer lagras som versionshanterad JSON. Behåll versionsnumret och hela dokumentet när du sparar en design. Mått anges i millimeter och belopp i heltalsöre. Det valda artikelnumret styr material, teknik och tillåten efterbehandling. Ta inte bort okända fält och bygg inte en separat renderare.

En design kan innehålla personuppgifter, foton och datarader. Skydda lagringen med autentisering, kontrollera ägarskap och tillämpa en lämplig gallringspolicy. Begär en produktionsrendering från CR80 i stället för att skriva ut en skärmbild från editorn.

Signerade starter, hanterade kundidentiteter, produktionsrendering och SPI kräver serverautentisering med avgränsade behörigheter och ett granskat dataflöde. De ingår inte i den här snabbstarten för webbläsaren. Be CR80 aktivera det integrationskontrakt som behövs. Ett publikt partner-ID är aldrig en API-nyckel.