Hosted-Checkout-Integration

Hosted Checkout ist eine fertige, von Volet.com gehostete Zahlungsseite.

Wie die Seite für Ihre Kunden aussieht, sehen Sie auf der Hosted-Checkout-Seite für Entwickler.

Ihre Anwendung erstellt eine Zahlungsanfrage und leitet den Kunden zu Hosted Checkout weiter. Der Kunde schließt die Zahlung ab, Volet.com sendet eine Statusbenachrichtigung an Ihren Server und leitet den Kunden anschließend auf Ihre Website zurück.

Hosted Checkout unterstützt:

Erstellen und konfigurieren Sie vor der Integration ein Hosted-Checkout-Gateway in Ihrem Konto. Siehe Zahlungs-Gateway erstellen.

Zahlungsablauf

Der Kunde gibt auf Ihrer Website eine Bestellung auf.
Ihre Website erzeugt eine Zahlungsanfrage und zeigt eine Zahlungsschaltfläche oder einen Link an.
Der Kunde klickt auf Bezahlen und wird zu Hosted Checkout weitergeleitet.
Der Kunde schließt die Zahlung ab.
Volet.com sendet eine Benachrichtigung zum Zahlungsstatus an Ihre Status URL.
Ihr System aktualisiert den Bestellstatus.
Hosted Checkout zeigt die Ergebnisseite der Zahlung an.
Der Kunde kann dann auf Weiter klicken und wird zu Ihrer Success URL oder Failed URL weitergeleitet.

Merchant website
      │
      ▼
Hosted Checkout
      │
      ▼
Payment
      │
      ▼
Status URL
      │
      ▼
Merchant backend
      │
      ▼
Customer redirect

Bei erfolgreichen Zahlungen enthält die Ergebnisseite die Transaktions-ID und die Zahlungsinformationen. Bei fehlgeschlagenen oder abgebrochenen Zahlungen zeigt sie die entsprechende Fehler- oder Abbruchmeldung.

Success URL und Failed URL können in den Hosted-Checkout-Einstellungen konfiguriert oder dynamisch in der Zahlungsanfrage übergeben werden.

hinweis

Verlassen Sie sich beim Aktualisieren des Bestellstatus immer auf die Benachrichtigungen an die Status URL, nicht allein auf Browser-Weiterleitungen.

Success URL und Failed URL dürfen nicht zur Bestimmung des endgültigen Zahlungsstatus verwendet werden.

Schnellstart mit Hosted Checkout

Schritt 1. Zahlungsanfrage erstellen

Hosted-Checkout-Endpunkt

https://account.volet.com/api/public/payment-gateway

Pflichtparameter

Um eine Zahlung zu erstellen, senden Sie ein HTML-Formular per POST an den oben genannten Endpunkt. Die Zahlungsanfrage muss folgende Pflichtparameter enthalten:

Parameter	Beschreibung
`ac_account_email`	E-Mail-Adresse Ihres Volet.com-Kontos
`ac_sci_name`	Name des Hosted Checkout
`ac_amount`	Zahlungsbetrag
`ac_currency`	Zahlungswährung (z. B. USD, EUR)
`ac_order_id`	Ihre eindeutige Bestellkennung
`ac_sign`	Digitale Signatur

Die vollständige Liste der unterstützten Parameter finden Sie unter Parameter der Zahlungsanfrage.

hinweis

Jede Zahlungsanfrage muss eine eindeutige ac_order_id verwenden.

Verwenden Sie Bestellkennungen nicht für verschiedene Zahlungen erneut.

Signatur der Anfrage

Erzeugen Sie den Parameter ac_sign, indem Sie den SHA-256-Hash der folgenden Zeichenkette berechnen:

ac_account_email:ac_sci_name:ac_amount:ac_currency:secret:ac_order_id

Dabei ist secret das Passwort, das Sie beim Erstellen des Hosted Checkout festgelegt haben.

Beispiel-Zeichenkette:

[email protected]:Store:100.00:USD:password:123

SHA-256-Hash:

eb9e7f491df701fe7d71c74551ae9e4226dfbed7e3a9cc4916e242d3c09f718e

Übergeben Sie den berechneten Hash im Parameter ac_sign.

Zahlungsanfrage senden

Senden Sie das HTML-Formular mit der Methode POST an den Hosted-Checkout-Endpunkt.

Beispiel einer Zahlungsanfrage

<form method="POST" action="https://account.volet.com/api/public/payment-gateway">
  <input type="hidden" name="ac_account_email" value="[email protected]">
  <input type="hidden" name="ac_sci_name" value="Store">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_currency" value="USD">
  <input type="hidden" name="ac_order_id" value="123">
  <input type="hidden" name="ac_sign" value="eb9e7f491df701fe7d71c74551ae9e4226dfbed7e3a9cc4916e242d3c09f718e">
  <button type="submit">VoletPay</button>
</form>

Schritt 2. Zahlungsbenachrichtigungen verarbeiten

Ändert sich der Zahlungsstatus, sendet Volet.com eine Benachrichtigung an Ihre Status URL.

Die Benachrichtigung wird je nach Hosted-Checkout-Konfiguration per GET oder POST zugestellt.

Sie enthält folgende Parameter:

Parameter	Beschreibung
`ac_transfer`	Volet.com-Transaktions-ID
`ac_transaction_status`	Zahlungsstatus
`ac_order_id`	Ihre Bestellkennung
`ac_amount`	Ursprünglicher Zahlungsbetrag
`ac_merchant_amount`	Ihrem Konto gutgeschriebener Betrag
`ac_merchant_currency`	Abrechnungswährung
`ac_start_date`	Datum und Uhrzeit der Transaktion
`ac_sci_name`	Name des Hosted Checkout
`ac_src_wallet`	Wallet des Kunden
`ac_dest_wallet`	Wallet des Händlers
`ac_buyer_email`	E-Mail-Adresse des Kunden (sofern verfügbar)
`ac_hash`	Signatur-Hash der Benachrichtigung

Die vollständige Liste der verfügbaren Parameter finden Sie unter Parameter der Zahlungsbenachrichtigung.

Prüfen Sie vor dem Aktualisieren des Bestellstatus die Signatur ac_hash, um sicherzustellen, dass die Benachrichtigung von Volet.com stammt.

warnung

Markieren Sie Bestellungen nicht aufgrund von Kundenweiterleitungen als bezahlt.

Warten Sie immer auf eine gültige Benachrichtigung an die Status URL und prüfen Sie die Signatur ac_hash, bevor Sie den Bestellstatus aktualisieren.

Beispiel einer Benachrichtigung an Ihre Status URL:

<form method="POST" action="https://merchant.example.com/status">
  <input type="hidden" name="ac_transfer" value="235f9d0b-b48f-462c-9949-621c4930490c">
  <input type="hidden" name="ac_transaction_status" value="COMPLETED">
  <input type="hidden" name="ac_order_id" value="123">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_merchant_amount" value="100.00">
  <input type="hidden" name="ac_merchant_currency" value="USD">
  <input type="hidden" name="ac_start_date" value="2026-06-23 12:30:00">
  <input type="hidden" name="ac_sci_name" value="Store">
  <input type="hidden" name="ac_src_wallet" value="USD123456789012">
  <input type="hidden" name="ac_dest_wallet" value="USD210987654321">
  <input type="hidden" name="ac_buyer_email" value="[email protected]">
  <input type="hidden" name="ac_hash" value="4ceab247ca917e0142b1a99015beaed9310cd6a85ab3bacf08ba44d5ac03590b">
</form>

Signatur der Benachrichtigung prüfen

Um die Benachrichtigung zu prüfen, berechnen Sie den SHA-256-Hash aus den folgenden Werten und vergleichen ihn mit dem empfangenen ac_hash.

Die Signatur-Zeichenkette wird in dieser Reihenfolge gebildet:

ac_transfer:ac_start_date:ac_sci_name:ac_src_wallet:ac_dest_wallet:ac_order_id:ac_amount:ac_merchant_currency:password

Dabei ist password das für das Gateway konfigurierte Hosted-Checkout-Passwort.

Beispiel-Zeichenkette:

235f9d0b-b48f-462c-9949-621c4930490c:2026-06-23 12:30:00:Store:USD123456789012:USD210987654321:123:100.00:USD:password

Berechnen Sie den SHA-256-Hash dieser Zeichenkette:

4ceab247ca917e0142b1a99015beaed9310cd6a85ab3bacf08ba44d5ac03590b

Vergleichen Sie den berechneten Hash mit dem empfangenen ac_hash. Die Werte müssen übereinstimmen, bevor Sie den Bestellstatus aktualisieren.

Nach erfolgreicher Prüfung der Signatur aktualisieren Sie die entsprechende Bestellung in Ihrem System mit dem empfangenen Zahlungsstatus.

Schritt 3. Integration testen

Prüfen Sie vor der Annahme echter Zahlungen:

Weiterleitung des Kunden zu Hosted Checkout.
Abschluss einer erfolgreichen Zahlung.
Zustellung der Benachrichtigungen an die Status URL.
Prüfung der Signatur von Benachrichtigungen.
Aktualisierung des Bestellstatus.
Weiterleitungen zur Success URL und Failed URL.
Behandlung fehlgeschlagener Zahlungen.

IP-Adressen der Benachrichtigungsserver

Wenn Ihre Infrastruktur IP-Allowlists oder Firewall-Regeln nutzt, lassen Sie eingehende Anfragen von folgenden Volet.com-Benachrichtigungsservern zu:

13.61.247.159

Erweiterte Konfiguration

Die folgenden Abschnitte beschreiben optionale Funktionen und erweiterte Integrationsszenarien.

Zahlungsmethode vorauswählen

Standardmäßig zeigt Hosted Checkout eine Seite zur Auswahl der Zahlungsmethode an.

Mit dem Parameter ac_ps können Sie in der Zahlungsanfrage eine Zahlungsmethode vorauswählen. Ist er angegeben, öffnet Hosted Checkout direkt den entsprechenden Zahlungsbildschirm und überspringt die Auswahl der Zahlungsmethode.

Fügen Sie den Parametern Ihrer Zahlungsanfrage folgende Felder hinzu:

Öffnet direkt die Anmeldeseite des Volet.com-Kontos:

<input type="hidden" name="ac_ps" value="VOLET">

Öffnet direkt die Zahlungsseite für USDT im Tron-Netzwerk:

<input type="hidden" name="ac_ps" value="USDTETHER">
<input type="hidden" name="ac_ps_protocol" value="TRON">

Öffnet direkt die Zahlungsseite für Bitcoin:

<input type="hidden" name="ac_ps" value="BITCOIN">

Das ist nützlich, wenn der Kunde bereits auf Ihrer Website eine Zahlungsmethode gewählt hat, bevor er zu Hosted Checkout weitergeleitet wird.

Sprache

Mit dem Parameter ac_client_lang legen Sie die Sprache der Hosted-Checkout-Oberfläche fest.

Beispiel:

<input type="hidden" name="ac_client_lang" value="en">

Ist keine Sprache angegeben, verwendet Hosted Checkout die für den Kunden verfügbare Standardsprache.

Benutzerdefinierte Felder

Sie können bis zu 10 benutzerdefinierte Felder in eine Zahlungsanfrage aufnehmen.

Volet.com verarbeitet diese Felder nicht und gibt sie unverändert in Benachrichtigungen an die Status URL und in Kundenweiterleitungen zurück.

Typische Anwendungsfälle:

Kunden-ID
Abo-ID
Interne Rechnungsnummer
Kommentar

Beispiel:

<input type="hidden" name="customer_id" value="12345">
<input type="hidden" name="subscription_id" value="sub_987">
<input type="hidden" name="invoice_no" value="INV-2026-001">
<input type="hidden" name="comment" value="Premium plan">

Sub-Händler

Mit dem Parameter ac_submerchant_url geben Sie die Website des Händlers an, in dessen Namen die Zahlung abgewickelt wird.

Beispiel:

<input type="hidden" name="ac_submerchant_url" value="https://merchant.example.com">

Diese Option ist für Zahlungsaggregatoren, Marktplätze und Plattformen gedacht, die Zahlungen für andere Händler abwickeln.

hinweis

Alle Anforderungen an Compliance, verbotene Tätigkeiten und Händlerverifizierung, die für Händler gelten, gelten auch für Sub-Händler.

URLs überschreiben

Folgende Parameter können direkt in der Zahlungsanfrage angegeben werden:

ac_success_url
ac_success_url_method
ac_fail_url
ac_fail_url_method
ac_status_url
ac_status_url_method

Beispiel:

<input type="hidden" name="ac_success_url" value="https://merchant.example.com/payment-success">
<input type="hidden" name="ac_success_url_method" value="GET">
<input type="hidden" name="ac_fail_url" value="https://merchant.example.com/payment-failed">
<input type="hidden" name="ac_fail_url_method" value="GET">
<input type="hidden" name="ac_status_url" value="https://merchant.example.com/payment-status">
<input type="hidden" name="ac_status_url_method" value="POST">

In der Anfrage übergebene Werte überschreiben die für das Hosted-Checkout-Gateway konfigurierten Standard-URLs.

Das ist nützlich, wenn mehrere Websites, Shops, Apps, Bots oder KI-Agenten dasselbe Hosted-Checkout-Gateway nutzen.

Außerdem können Sie so für einzelne Bestellungen unterschiedliche Erfolgs-, Fehler- und Callback-URLs erzeugen, ohne mehrere Hosted-Checkout-Gateways anzulegen.

Signaturen deaktivieren

Der Parameter ac_sign ist optional, wenn digitale Signaturen in den Hosted-Checkout-Einstellungen deaktiviert sind.

Wir empfehlen jedoch dringend, in Produktivumgebungen Signaturen zu verwenden, um die Echtheit von Anfragen zu prüfen und Datenmanipulation zu verhindern.

Unsignierte Anfragen sollten nur für Tests und Entwicklung verwendet werden.

Hosted-Checkout-Referenz

Parameter der Zahlungsanfrage

Die Zahlungsanfrage ist ein HTML-Formular, das Ihre Anwendung an Hosted Checkout sendet.

Sie enthält die Zahlungsdetails, Händlerinformationen, Weiterleitungs-URLs und optionale Konfigurationsparameter, die zur Verarbeitung einer Zahlung erforderlich sind.

Die folgende Tabelle listet alle unterstützten Parameter der Zahlungsanfrage auf.

Parameter	Pflicht	Format	Beschreibung	Beispiele
`ac_account_email`	Ja	String	E-Mail-Adresse Ihres Volet.com-Kontos.	`[email protected]`
`ac_sci_name`	Ja	String (max. 50 Zeichen)	Name des Hosted Checkout.	`My Store`
`ac_amount`	Ja	Dezimalzahl	Betrag der Zahlungsanfrage. Die Anzahl der Nachkommastellen hängt von der gewählten Währung ab. Überzählige Nachkommastellen werden automatisch abgeschnitten.	`100.00`, `49.0302`, `0.12345678`
`ac_currency`	Ja	Währungscode	Währung der Zahlungsanfrage.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`
`ac_order_id`	Ja	String (max. 64 Zeichen; `"A-z"`, `"-"`, `"_"`, `"0-9"`)	Eindeutige Bestellkennung des Händlers.	`123456`, `baf419d9-6c82-4175-b870-5541b0ff3794`
`ac_sign`	Bedingt	Hex-String (SHA-256)	Anfragesignatur zur Prüfung der Integrität der Zahlungsanfrage. Erforderlich, wenn die Signaturprüfung für den Hosted Checkout aktiviert ist.	`36b4c9ad29b61d1c5996e3ef1a3af0c3194e19713613b6bf26a9b905b8019225`
`ac_ps`	Nein	String (ID der Zahlungsmethode)	Beim Öffnen von Hosted Checkout vorausgewählte Zahlungsmethode.	`VOLET`, `USDTETHER`, `USD_COIN`, `BITCOIN`, `ETHEREUM`, `RIPPLE`, `TRON`, `LITECOIN`, `TON`, `SOL`, `BNB`, `MATIC` (für POLYGON), `AVAX`
`ac_ps_protocol`	Bedingt	String (Blockchain- oder Protokoll-ID)	Vorausgewähltes Blockchain-Netzwerk. Erforderlich, wenn ac_ps USDTETHER, USD_COIN oder BNB ist, sonst optional.	`ETHEREUM`, `TRON`, `BINANCE_SMART_CHAIN`, `MATIC` (für POLYGON), `SOLANA`, `AVALANCHE`, `OPTIMISM`, `ARBITRUM`, `TON`
`ac_comments`	Nein	String (max. 255 Zeichen)	Zusätzliche Zahlungsbeschreibung, die dem Kunden angezeigt wird und nicht geändert werden kann.	`Payment for Order #1234`
`ac_success_url`	Nein	String (max. 100 Zeichen)	Überschreibt die konfigurierte Success URL.	`https://merchant.example.com/success`
`ac_success_url_method`	Nein	`GET`, `POST`	HTTP-Methode für die Weiterleitung zur Success URL. Überschreibt die Hosted-Checkout-Konfiguration.	`GET`
`ac_fail_url`	Nein	String (max. 100 Zeichen)	Überschreibt die konfigurierte Failed URL.	`https://merchant.example.com/failed`
`ac_fail_url_method`	Nein	`GET`, `POST`	HTTP-Methode für die Weiterleitung zur Failed URL. Überschreibt die Hosted-Checkout-Konfiguration.	`POST`
`ac_status_url`	Nein	String (max. 100 Zeichen)	Überschreibt die konfigurierte Status URL.	`https://merchant.example.com/status`
`ac_status_url_method`	Nein	`GET`, `POST`	HTTP-Methode für Benachrichtigungen an die Status URL. Überschreibt die Hosted-Checkout-Konfiguration.	`POST`
`ac_client_lang`	Nein	String (Sprachcode)	Sprache der Hosted-Checkout-Seite.	`en`
`ac_submerchant_url`	Nein	String (max. 100 Zeichen)	Website-URL des Sub-Händlers. Wird für Plattformintegrationen verwendet und ist für bestimmte Händlerkategorien erforderlich.	`https://seller.example.com`
Benutzerdefinierte Felder (zum Beispiel `buyer_email`, `client_email`)	Nein	Bis zu 10 String-Werte (je max. 100 Zeichen)	Zusätzliche, vom Händler definierte Felder, die unverändert in Benachrichtigungen an die Status URL und in Kundenweiterleitungen zurückgegeben werden. Nutzen Sie sie, um Zahlungen Ihren eigenen Bestellungen, Kunden, Rechnungen oder anderen internen Datensätzen zuzuordnen.	`[email protected]`, `#INV-12345`, `user_1001`

Beispiel

<form method="POST" action="https://account.volet.com/api/public/payment-gateway">
  <input type="hidden" name="ac_account_email" value="[email protected]">
  <input type="hidden" name="ac_sci_name" value="My Store">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_currency" value="USD">
  <input type="hidden" name="ac_order_id" value="order_123456">
  <input type="hidden" name="ac_sign" value="36b4c9ad29b61d1c5996e3ef1a3af0c3194e19713613b6bf26a9b905b8019225">

  <input type="hidden" name="ac_ps" value="USDTETHER">
  <input type="hidden" name="ac_ps_protocol" value="ETHEREUM">
  <input type="hidden" name="ac_comments" value="Payment for Order #123456">

  <input type="hidden" name="ac_success_url" value="https://merchant.example.com/payment-success">
  <input type="hidden" name="ac_success_url_method" value="GET">
  <input type="hidden" name="ac_fail_url" value="https://merchant.example.com/payment-failed">
  <input type="hidden" name="ac_fail_url_method" value="GET">
  <input type="hidden" name="ac_status_url" value="https://merchant.example.com/payment-status">
  <input type="hidden" name="ac_status_url_method" value="POST">

  <input type="hidden" name="ac_client_lang" value="en">
  <input type="hidden" name="ac_submerchant_url" value="https://seller.example.com">

  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="customer_12345">
  <input type="hidden" name="customer_email" value="[email protected]">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
  <input type="hidden" name="subscription_id" value="sub_98765">
  <input type="hidden" name="merchant_internal_id" value="seller_456">

  <button type="submit">Pay with Volet.com</button>
</form>

Parameter bei erfolgreicher Zahlung

Nach einer erfolgreichen Zahlung leitet Hosted Checkout den Kunden zu Ihrer Success URL weiter und übergibt die Zahlungsdetails mit der konfigurierten Weiterleitungsmethode.

Die folgende Tabelle beschreibt alle verfügbaren Parameter.

Parameter	Format	Beschreibung	Beispiele
`ac_src_wallet`	String	Wallet-Nummer des Kunden, die für die Zahlung verwendet wurde.	`USDT123456789012`
`ac_dest_wallet`	String	Wallet-Nummer des Händlers oder Abrechnungs-Wallet.	`USD123456789012`
`ac_amount`	Dezimalzahl	Betrag der Zahlungsanfrage.	`100.00`, `0.12500000`
`ac_merchant_amount`	Dezimalzahl	Dem Händlerkonto gutgeschriebener Betrag.	`100.00`
`ac_merchant_currency`	Währungscode	Abrechnungswährung.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`
`ac_fee`	Dezimalzahl	Für die Zahlung berechnete Bearbeitungsgebühr.	`0.50`
`ac_buyer_amount_without_commission`	Dezimalzahl	Vom Kunden gezahlter Betrag ohne vom Kunden getragene Gebühren, falls zutreffend.	`100.00`
`ac_buyer_amount_with_commission`	Dezimalzahl	Vom Kunden gezahlter Gesamtbetrag einschließlich vom Kunden getragener Gebühren.	`100.50`
`ac_buyer_currency`	Währungscode	Währung, mit der der Kunde die Zahlung abgeschlossen hat.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`, `BNB`, `AVAX`, `POL`
`ac_transfer`	UUID	Eindeutige Volet.com-Transaktionskennung.	`235f9d0b-b48f-462c-9949-621c4930490c`
`ac_sci_name`	String	Name des Hosted Checkout.	`My Store`
`ac_start_date`	`YYYY-MM-DD HH:mm:ss` (UTC)	Datum und Uhrzeit der Zahlungserstellung.	`2026-06-23 12:30:00`
`ac_order_id`	String	In der Zahlungsanfrage angegebene Bestellkennung des Händlers.	`123456`, `baf419d9-6c82-4175-b870-5541b0ff3794`
`ac_ps`	String (ID der Zahlungsmethode)	Vom Kunden verwendete Zahlungsmethode.	`VOLET`, `USDT`, `USDC`, `BTC`, `ETH`, `TRX`, `SOL`
`ac_transaction_status`	Status	Endgültiger Zahlungsstatus. Mögliche Werte: `PENDING`, `PROCESS`, `COMPLETED`, `CANCELED`.	`COMPLETED`
`ac_buyer_email`	String (E-Mail-Adresse)	E-Mail-Adresse des Kunden, sofern verfügbar.	`[email protected]`
`ac_buyer_verified`	Boolean	Gibt an, ob das Kundenkonto verifiziert ist.	`true`, `false`
`ac_comments`	String	In der Zahlungsanfrage angegebener Kommentar.	`Order #123456`
Benutzerdefinierte Felder	String	Vom Händler definierte Felder, die unverändert aus der Zahlungsanfrage zurückgegeben werden.	`customer_id`, `invoice_id`, `subscription_id`

Beispiel

<form method="POST" action="https://merchant.example.com/payment-success">
  <input type="hidden" name="ac_src_wallet" value="USDT210987654321">
  <input type="hidden" name="ac_dest_wallet" value="USD123456789012">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_merchant_amount" value="99.50">
  <input type="hidden" name="ac_merchant_currency" value="USD">
  <input type="hidden" name="ac_fee" value="0.50">
  <input type="hidden" name="ac_buyer_amount_without_commission" value="100.00">
  <input type="hidden" name="ac_buyer_amount_with_commission" value="100.00">
  <input type="hidden" name="ac_buyer_currency" value="USDT">
  <input type="hidden" name="ac_transfer" value="235f9d0b-b48f-462c-9949-621c4930490c">
  <input type="hidden" name="ac_sci_name" value="My Store">
  <input type="hidden" name="ac_start_date" value="2026-06-23 12:30:00">
  <input type="hidden" name="ac_order_id" value="order_123456">
  <input type="hidden" name="ac_ps" value="VOLET">
  <input type="hidden" name="ac_transaction_status" value="COMPLETED">
  <input type="hidden" name="ac_buyer_email" value="[email protected]">
  <input type="hidden" name="ac_buyer_verified" value="true">
  <input type="hidden" name="ac_comments" value="Order #123456">
  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="customer_12345">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
  <input type="hidden" name="subscription_id" value="sub_98765">
</form>

Parameter bei fehlgeschlagener Zahlung

Wird eine Zahlung abgebrochen oder schlägt sie fehl, leitet Hosted Checkout den Kunden zu Ihrer Failed URL weiter und übergibt die Zahlungsdetails mit der konfigurierten Weiterleitungsmethode.

Die folgende Tabelle beschreibt alle verfügbaren Parameter.

Parameter	Format	Beschreibung	Beispiele
`ac_dest_wallet`	String	Händlerkonto oder Abrechnungs-Wallet.	`USD123456789012`
`ac_amount`	Dezimalzahl	Betrag der Zahlungsanfrage.	`100.00`, `49.95`
`ac_currency`	Währungscode	Währung der Zahlungsanfrage.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`
`ac_sci_name`	String	Name des Hosted Checkout.	`My Store`
`ac_order_id`	String	In der Zahlungsanfrage angegebene Bestellkennung des Händlers.	`order_123456`, `baf419d9-6c82-4175-b870-5541b0ff3794`
Benutzerdefinierte Felder	String	Vom Händler definierte Felder, die unverändert aus der Zahlungsanfrage zurückgegeben werden.	`customer_id`, `invoice_id`, `subscription_id`

Beispiel

<form method="POST" action="https://merchant.example.com/payment-failed">
  <input type="hidden" name="ac_dest_wallet" value="USD123456789012">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_currency" value="USD">
  <input type="hidden" name="ac_sci_name" value="My Store">
  <input type="hidden" name="ac_order_id" value="order_123456">
  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="customer_12345">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
  <input type="hidden" name="subscription_id" value="sub_98765">
</form>

Parameter der Zahlungsbenachrichtigung

Ändert sich der Zahlungsstatus, sendet Hosted Checkout mit der konfigurierten Methode (GET oder POST) eine Benachrichtigung an Ihre Status URL.

Die Benachrichtigung enthält alle Parameter einer erfolgreichen Zahlung sowie zusätzlich die Signatur ac_hash.

Parameter	Format	Beschreibung	Beispiele
`ac_hash`	SHA-256-Hash (Hex-String)	SHA-256-Signatur zur Prüfung, dass die Benachrichtigung von Volet.com gesendet und unterwegs nicht verändert wurde.	`1cd6c127c5c49b6d5060cec4bdbf06608216c0c11cc76acebb546be0f7081afd`

Wie Sie die Signatur erzeugen und prüfen, erfahren Sie unter Signatur der Benachrichtigung prüfen.

Beispiel einer Benachrichtigung

<form method="POST" action="https://merchant.example.com/status">
  <input type="hidden" name="ac_src_wallet" value="USDT210987654321">
  <input type="hidden" name="ac_dest_wallet" value="USD123456789012">
  <input type="hidden" name="ac_amount" value="123.45">
  <input type="hidden" name="ac_merchant_amount" value="123.55">
  <input type="hidden" name="ac_merchant_currency" value="USD">
  <input type="hidden" name="ac_fee" value="0.10">
  <input type="hidden" name="ac_buyer_amount_without_commission" value="123.45">
  <input type="hidden" name="ac_buyer_amount_with_commission" value="123.55">
  <input type="hidden" name="ac_buyer_currency" value="USD">
  <input type="hidden" name="ac_transfer" value="235f9d0b-b48f-462c-9949-621c4930490c">
  <input type="hidden" name="ac_sci_name" value="My Shop">
  <input type="hidden" name="ac_start_date" value="2026-06-23 12:30:00">
  <input type="hidden" name="ac_order_id" value="123456">
  <input type="hidden" name="ac_ps" value="VOLET">
  <input type="hidden" name="ac_transaction_status" value="COMPLETED">
  <input type="hidden" name="ac_buyer_email" value="[email protected]">
  <input type="hidden" name="ac_buyer_verified" value="true">
  <input type="hidden" name="ac_comments" value="Payment for order #123456">
  <input type="hidden" name="ac_hash" value="1cd6c127c5c49b6d5060cec4bdbf06608216c0c11cc76acebb546be0f7081afd">
  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="98765">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
</form>

Zahlungsablauf​

Schnellstart mit Hosted Checkout​

Schritt 1. Zahlungsanfrage erstellen​

Hosted-Checkout-Endpunkt​

Pflichtparameter​

Signatur der Anfrage​

Zahlungsanfrage senden​

Beispiel einer Zahlungsanfrage​

Schritt 2. Zahlungsbenachrichtigungen verarbeiten​

Signatur der Benachrichtigung prüfen​

Schritt 3. Integration testen​

IP-Adressen der Benachrichtigungsserver​

Erweiterte Konfiguration​

Zahlungsmethode vorauswählen​

Sprache​

Benutzerdefinierte Felder​

Sub-Händler​

URLs überschreiben​

Signaturen deaktivieren​

Hosted-Checkout-Referenz​

Parameter der Zahlungsanfrage​

Beispiel​

Parameter bei erfolgreicher Zahlung​

Beispiel​

Parameter bei fehlgeschlagener Zahlung​

Beispiel​

Parameter der Zahlungsbenachrichtigung​

Beispiel einer Benachrichtigung​

Zahlungsablauf

Schnellstart mit Hosted Checkout

Schritt 1. Zahlungsanfrage erstellen

Hosted-Checkout-Endpunkt

Pflichtparameter

Signatur der Anfrage

Zahlungsanfrage senden

Beispiel einer Zahlungsanfrage

Schritt 2. Zahlungsbenachrichtigungen verarbeiten

Signatur der Benachrichtigung prüfen

Schritt 3. Integration testen

IP-Adressen der Benachrichtigungsserver

Erweiterte Konfiguration

Zahlungsmethode vorauswählen

Sprache

Benutzerdefinierte Felder

Sub-Händler

URLs überschreiben

Signaturen deaktivieren

Hosted-Checkout-Referenz

Parameter der Zahlungsanfrage

Beispiel

Parameter bei erfolgreicher Zahlung

Beispiel

Parameter bei fehlgeschlagener Zahlung

Beispiel

Parameter der Zahlungsbenachrichtigung

Beispiel einer Benachrichtigung