Skip to content
aYOUne
Not in your language

This page is not yet available in en. You're reading the de version.

Zugänge für Zahlung, Versand, Mail und Google Merchant

Zugänge für Zahlung, Versand, Mail und Google Merchant einrichten

Diese Anleitung zeigt, wie Sie die Zugänge zu Stripe, PayPal, DHL, SparkPost und Google Merchant Center hinterlegen, prüfen und mit der Stelle verknüpfen, an der sie verwendet werden.

Wo: Konto → Firmen-Zugangsdaten → Geheimnis hinzufügen. Wählen Sie den Anbieter; das Formular zeigt danach genau die Felder, die dieser Anbieter braucht. Alle Werte werden verschlüsselt gespeichert und nie wieder im Klartext angezeigt.

Prüfen: In der Liste der Firmen-Zugangsdaten das Symbol Verbindung prüfen wählen. Die Prüfung liest nur, sie bucht nichts und erzeugt nichts. Auch bei Erfolg kann ein Hinweis erscheinen (zum Beispiel ein fehlendes optionales Feld) — lesen Sie ihn vor dem ersten echten Einsatz.


Stripe (Kartenzahlung, Apple Pay, Google Pay)

  1. Im Stripe-Dashboard → Entwickler → API-Schlüssel den Secret Key kopieren (beginnt mit sk_live_; ein eingeschränkter Schlüssel rk_live_ geht ebenfalls).
  2. In den Firmen-Zugangsdaten Anbieter Stripe, Art API key wählen und den Secret Key einfügen.
  3. Unter Konfiguration → Zahlungsanbieter den Eintrag „Stripe" öffnen und im Feld Zugangsdaten den neuen Zugang auswählen.
  4. Am selben Zahlungsanbieter Stripe-Webhooks einrichten ausführen. Die Plattform legt die Webhook-Adresse in Ihrem Stripe-Konto selbst an und speichert das Signiergeheimnis — Sie tragen im Stripe-Dashboard nichts von Hand ein. Mit Webhook-Stand prüfen sehen Sie jederzeit, ob alles verbunden ist.

Publishable Key (pk_live_…, ebenfalls unter API-Schlüssel): Er wird für die eingebettete Kasse sowie Apple Pay und Google Pay gebraucht. Die Weiterleitung zur Stripe-Kasse funktioniert auch ohne ihn. Das Eingabefeld im Formular folgt; bis dahin lässt er sich über die Kommandozeile am bestehenden Zugang ergänzen: Kennung mit ay credentials list --provider stripe ermitteln, dann ay credentials update <Kennung> --client-id pk_live_…. Die Verbindungsprüfung meldet, wenn er fehlt oder nicht zum Modus des Secret Keys passt (Live/Test).

PayPal

  1. Im PayPal-Entwicklerportal (developer.paypal.com) → Apps & Credentials → Reiter Live → Ihre App öffnen (oder anlegen).
  2. Client ID und Secret kopieren.
  3. In den Firmen-Zugangsdaten Anbieter PayPal wählen und beide Werte eintragen.
  4. Unter Konfiguration → Zahlungsanbieter den Eintrag „PayPal" öffnen und den Zugang auswählen.
  5. Am selben Zahlungsanbieter PayPal-Webhook einrichten ausführen. Die Plattform legt den Webhook in Ihrer PayPal-App selbst an (Adresse https://hooks.ayoune.app/payment/paypal) und hinterlegt seine Webhook-ID verschlüsselt — Sie tragen im PayPal-Portal nichts von Hand ein. Ohne diesen Schritt werden Zahlungsmeldungen von PayPal abgewiesen. Mit Webhook-Stand prüfen sehen Sie jederzeit, ob alles verbunden ist.

Live oder Sandbox: Die Plattform spricht PayPal für jeden Zugang in der Umgebung an, zu der er gehört. Die Verbindungsprüfung erkennt, ob die Daten zu Live oder Sandbox gehören, und meldet, wenn die Plattform den Zugang in der anderen Umgebung ansprechen würde — dann nennt sie die Basis-Adresse, die am Zugang einzutragen ist (https://api-m.paypal.com für Live, https://api-m.sandbox.paypal.com für Sandbox). Andere Adressen werden aus Sicherheitsgründen ignoriert. Das Eingabefeld Basis-Adresse im Formular folgt; bis dahin richtet der Support die Umgebung für Sie ein.

DHL Paket (Geschäftskunden-Versand)

  1. Im DHL Developer Portal (developer.dhl.com) → My Apps eine App mit der API Parcel DE Shipping anlegen und den API Key kopieren. Das API Secret derselben App ist optional.
  2. Im DHL Geschäftskundenportal einen Systembenutzer mit Passwort anlegen (empfohlen statt eines persönlichen Logins).
  3. Die EKP bereithalten — Ihre 10-stellige DHL-Kundennummer (steht auf Vertrag und Rechnung).
  4. Für Retourenetiketten: Geschäftskundenportal → Retouren → Einstellungen → Retouren-Empfänger-ID.
  5. In den Firmen-Zugangsdaten Anbieter DHL Paket wählen und eintragen: API-Schlüssel, Benutzer, Passwort, EKP, optional Retouren-Empfänger-ID und API-Secret. Das Feld API base URL leer lassen (Produktion); nur für Tests die Sandbox-Adresse eintragen.
  6. Unter E-Commerce → Versandarten im Abschnitt Versanddienstleister DHL als Anbieter wählen. Ein bestimmter Zugang muss nur gewählt werden, wenn Sie mehrere DHL-Zugänge haben — sonst gilt der aktive.

SparkPost (Mailversand)

  1. In SparkPost (app.sparkpost.com, US-Region) → Configuration → API Keys einen Schlüssel mit den Rechten Transmissions: Read/Write und Sending Domains: Read/Write anlegen.
  2. Unter Sending Domains Ihre Absender-Domain anlegen und per DNS bestätigen (DKIM). Ohne bestätigte Absender-Domain lehnt SparkPost jede Mail ab.
  3. In den Firmen-Zugangsdaten Anbieter SparkPost wählen und den Schlüssel einfügen. Ein Zugang je Unternehmen genügt.
  4. Der Zugang wird automatisch verwendet, sobald in den Mail-Einstellungen der Versand über SparkPost eingeschaltet ist.

Die Verbindungsprüfung listet Ihre Absender-Domains und nennt die, die noch nicht bestätigt sind. Konten der EU-Region (sparkpost.eu) werden derzeit nicht unterstützt.

Google Merchant Center (Produkt-Feed)

Diesen Zugang legen Sie nicht in den Firmen-Zugangsdaten an.

  1. Einkauf → Handelskanäle öffnen und einen Kanal mit dem Anbieter Google anlegen oder öffnen.
  2. Im Reiter Google Merchant Google Merchant verbinden wählen, die angezeigte Adresse öffnen, mit dem Google-Konto anmelden, das Zugriff auf Ihr Merchant Center hat, und zustimmen.
  3. Zurück im Kanal Ihre Merchant-Center-ID sowie Zielland und Sprache eintragen und speichern.

Der Zugang erscheint danach automatisch in den Firmen-Zugangsdaten; Verbindung prüfen zeigt, wie viele Merchant-Konten erreichbar sind. Ein abgelaufenes Zugriffstoken erneuert der Abgleich selbst.

Work with this page

Ready-made instructions for your AI tool. Copy, paste, go — the AI fetches the content itself via the address in the text.

Summarise the steps for me The essentials, in the right order.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/getting-started/zugaenge-zahlung-versand-mail-merchant.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Summarise the content for me.

- First, in two sentences: what is this about?
- Then the steps in the order I need to take them.
- One line per step, in plain language.
- At the end: what I should have ready beforehand.

Leave out nothing I need in order to actually finish.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Explain what I need this for What it is good for — and when it is worth it.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/getting-started/zugaenge-zahlung-versand-mail-merchant.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Explain to me what I need this for.

1. Which problem does it solve? In one sentence, from my point of view.
2. Three typical situations in which it genuinely helps me.
3. When I do NOT need it — that saves me time.
4. What I can do instead if it is not a fit.

Stick to what the source says. Where it gives nothing, say so openly instead
of guessing.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Help me set this up Step by step, asking me as you go.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/getting-started/zugaenge-zahlung-versand-mail-merchant.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Walk me through the setup step by step.

- First tell me what I need to have ready (access, data, time).
- Then take me through ONE step at a time. Wait for my "next".
- For each step, say how I can tell that it worked.
- If something goes wrong, ask me for the exact message instead of guessing.

If the instructions leave a point open, tell me so rather than inventing it.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Help me with a problem Narrow down the cause instead of guessing.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/getting-started/zugaenge-zahlung-versand-mail-merchant.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Help me narrow down a problem.

- First ask me what I observe and what I expected instead.
- From that, derive the most likely causes consistent with this source.
- For each cause, give me ONE test that confirms or rules it out.
- Order them so the cheapest test comes first.

Do not guess. If the source does not cover the problem, tell me where I should
look next.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Explain it in plain words No jargon, from the ground up.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/getting-started/zugaenge-zahlung-versand-mail-merchant.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Explain the content so that someone without prior knowledge understands it.

- Start with the purpose: why does this exist at all?
- Explain technical terms in half a sentence on first use.
- One everyday comparison where it genuinely holds — none where it limps.
- At the end: the three things worth remembering.

Do not shorten by dropping conditions. A simplification that hides a
prerequisite is a false statement.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
A checklist to tick off To follow along while you do it.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/getting-started/zugaenge-zahlung-versand-mail-merchant.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Turn this into a **tick-off checklist** for practical use.

- Exactly one action per item, in the imperative.
- Order it so that no item depends on a later prerequisite.
- Prerequisites and pitfalls as indented sub-items.
- End with an acceptance step: how do I know everything is right?
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Was this article helpful?

👎 No (0)
Leave a comment