Checkout SDK – Deine Seite. COPE-Payments. Nahtlos verbunden.

Das COPE Checkout SDK ist ein Browser-SDK (eine Bibliothek, die die Integration in dein Projekt vereinfacht) für Buyer Checkout Flows. Es gibt dir die Kontrolle über Produktseite und Einkaufserlebnis, während COPE Zahlungsabwicklung, Steuerberechnung und Bestellerstellung übernimmt.

Nutze das SDK, wenn deine Seite das Produkt- und Shopping-Erlebnis besitzt – und COPE den Rest.

📄 Die vollständige Dokumentation findest du hier: [Checkout SDK overview - COPE]

Installation

bash

npm install @copecart/sdk

import { CopeCart } from "@copecart/sdk"  const cope = new CopeCart({   publishableKey: "cope_pk_live_...", })

Ohne Bundler – globaler Build:

html

<script src="https://unpkg.com/@copecart/sdk@latest/dist/index.global.js"></script> <script>   const cope = new CopeCart.CopeCart({     publishableKey: "cope_pk_live_...",   }) </script>

Das SDK erfordert HTTPS – außer http://localhost während der Entwicklung.

Konfiguration

Option	Pflicht	Standard	Hinweis
`publishableKey`	Ja	–	Beginnt mit `cope_pk_`, sicher im Browser
`baseUrl`	Nein	COPE Production API	Nur auf Anweisung von COPE Support ändern
`checkoutBaseUrl`	Nein	Origin von `baseUrl`	Validiert Checkout-URLs der API

Typischer Flow

const product = await cope.getProduct("prd_...") const cart = await cope.createCart({ currency: product.currency })  await cope.addLine(cart.id, {   product_id: product.id,   plan_id: product.payment_plans[0].id,   quantity: 1, })  await cope.setBuyerIdentity(cart.id, {   email: "buyer@example.com",   tax_location: { country: "DE", postal_code: "10115" }, })  await cope.reprice(cart.id)  const checkout = await cope.checkout(cart.id, {   success_url: "https://your-site.example/thank-you",   cancel_url: "https://your-site.example/cart",   consents: [{ type: "buyer_tos" }], })  cope.redirectToCheckout(checkout)

Nach erfolgreicher Zahlung leitet COPE zur success_url weiter – mit angehängter order_id:

https://your-site.example/thank-you?order_id=ord_...

Core Methods

Methode	Zweck
`getProduct(productId)`	Produktdetails und Zahlungspläne abrufen
`createCart(payload)`	Cart erstellen und Checkout-Credential speichern
`addLine(cartId, payload)`	Produkt, Plan und Menge hinzufügen
`setBuyerIdentity(cartId, payload)`	Standort und Kontaktdaten für Steuer und Checkout setzen
`reprice(cartId)`	Steuern, Rabatte und finale Preise berechnen
`checkout(cartId, payload)`	Hosted Checkout Session erstellen
`redirectToCheckout(checkout)`	Browser zum Hosted Checkout weiterleiten
`cancelCheckout(checkoutId)`	Offene Checkout Session abbrechen

Fehlerbehandlung

import {   CopeApiError,   CopeCartExpiredError,   CopeNetworkError, } from "@copecart/sdk"  try {   await cope.reprice(cart.id) } catch (error) {   if (error instanceof CopeApiError) {     console.log(error.status, error.code, error.errors)   }   if (error instanceof CopeCartExpiredError) {     const replacement = await cope.createCart({ currency: "EUR" })   }   if (error instanceof CopeNetworkError) {     console.log("Später erneut versuchen")   } }

4xx-Fehler sind permanent – Payload korrigieren und mit neuem Request erneut versuchen. Bei transienten Netzwerk- oder Serverfehlern führt das SDK automatisch Retries mit Backoff durch.

Use Cases

Eigene Produktseite
Du baust das UI, COPE übernimmt Zahlungsabwicklung, Steuerberechnung und Bestellerstellung. Ideal wenn du volle Kontrolle über das Kauferlebnis haben willst, ohne ein eigenes Payment-Backend bauen zu müssen.

Multi-Plan Produkte
Zahlungspläne dynamisch aus COPE abrufen und dem Nutzer zur Auswahl präsentieren – monatlich, jährlich, Einmalzahlung. Das SDK liefert alle verfügbaren Pläne direkt mit dem Produkt.

Zahlungslinks
Checkout Session serverseitig erstellen und die hosted_checkout_url per E-Mail, WhatsApp oder CRM versenden – ohne eigene Checkout-UI.

Einfacher Go-Live
Schnelle Integration ohne eigenes Payment-Backend. COPE übernimmt PCI-Compliance, Steuerlogik und den gesamten Payment Flow.

Verwandte Artikel