Priem
Anmelden Loslegen

Zahlungsannahme — Krypto und Karte

Ihr Kunde zahlt, womit er will. Sie bekommen genau das, was Sie bestellt haben.

An der Kasse wählt Ihr Käufer jede Münze und jedes Netz — Bitcoin, Ether, USDT, USDC — oder zahlt mit einer gewöhnlichen Karte. Ihnen wird in der Währung gutgeschrieben, die Sie festgelegt haben. Der Zahlungslink kommt ohne eine einzige Zeile Code auf Ihre Seite; die API brauchen Sie nur, wenn der Betrag aus dem Warenkorb stammt.

Loslegen Dokumentation

1,5% pro Zahlung. Das Konto öffnet sofort, die Annahme startet nach der Prüfung.

  1. 01KäuferZahlt mit Münze oder Karte an Ihrer Kasse
  2. 02NetzDie Überweisung erscheint, Bestätigungen sammeln sich
  3. 03TauschDas Eingegangene wird in Ihre Währung getauscht
  4. 04Ihr GuthabenStatus settled — Sie können liefern

01 / Anbindung

Zwei Wege, und sie schließen einander nicht aus

Ein Button mit Link deckt die meisten Fälle ab. Die API brauchen Sie dort, wo der Preis auf Ihrer Seite entsteht.

Ohne Code

Preisschild

Im Konto anlegen, Link kopieren, als Button auf die Seite setzen. Der Preis ist fest oder wird vom Käufer selbst eingegeben.

Ein Preisschild ist mehrfach nutzbar — für einen Katalogartikel, oder einmalig — für die Rechnung an eine bestimmte Person. Das einmalige schließt in dem Moment, in dem der erste Käufer zur Zahlung geht: zwei, die den Link gleichzeitig geöffnet haben, zahlen nicht zweimal für dieselbe Ware.

<a href="https://api.priem.io/pay/IHR-PREISSCHILD">
  Mit Krypto bezahlen
</a>

Wenn der Betrag aus dem Warenkorb kommt

API

Ihr Server legt die Zahlung über den nötigen Betrag an und führt den Käufer auf den zurückgegebenen Link. Das Projekt wird über den Schlüssel bestimmt, im Body muss es also nicht stehen.

POST https://api.priem.io/v1/payments
Authorization: Bearer priem_…

{
  "amount": "49.00",
  "currency": "USD",
  "idempotencyKey": "order-12345"
}

Nehmen Sie den Idempotenzschlüssel aus Ihrer Bestellnummer, nicht aus der Uhrzeit und nicht zufällig. Eine wiederholte Anfrage mit demselben Schlüssel liefert dieselbe Zahlung zurück, statt eine zweite Rechnung zu stellen. Ein Schlüssel aus Date.now() schützt vor gar nichts.

Die Kartenzahlung läuft an derselben Kasse und Sie müssen dafür nichts einrichten. Der Käufer kauft Bitcoin beim Anbieter, er landet direkt auf der Adresse der Rechnung, und die Zahlung läuft wie jede andere.

Das Kartenminimum sind 10 Dollar. Darunter erscheint der Button gar nicht, und dem Käufer wird gesagt, warum.

02 / Geld

Was es kostet — vollständig

Es gibt drei Gebühren und nur eine ist unsere. Die anderen beiden nimmt das Netz, und wir zeigen sie hier statt nach dem Anschluss.

An uns, pro Zahlung

1,5%

Wird bei der Gutschrift einbehalten und steht im Callback als eigenes Feld.

Ans Netz, bei Auszahlung

~1 USDT

Fest auf TRON, zahlen Sie. Ansammeln und auf einmal auszahlen ist billiger als Zahlung für Zahlung.

Ans Netz, bei Zahlung

Zahlt der Käufer

Zusätzlich zu Ihrem Preis. Sie hängt nicht am Betrag, bei kleinen Bestellungen fällt sie deshalb auf.

Der Netzaufschlag, den der Käufer vor dem Bestätigen sieht
Zahlt mit5 $30 $100 $
USDT auf BSC+1,3%+0,5%+0,3%
USDT auf TON+9,3%+1,8%+0,8%
USDT auf TRON+16,3%+3,0%+1,1%
USDT auf Ethereum+19,5%+3,5%+1,3%

Einschränkung Unter 10 Dollar lässt sich per Krypto schwer verkaufen. Bei drei Dollar frisst selbst ein günstiges Netz einen sichtbaren Anteil, und TRON oder Ethereum legen ein Viertel des Preises drauf. Wenn Ihre Tarife klein sind, verkaufen Sie sie im Paket. Wir sagen das vor dem Anschluss, nicht nach den ersten abgebrochenen Bestellungen.

03 / Für Entwickler

Eine Integration für einen Abend

Zahlung anlegen, Callback abwarten, Signatur prüfen, bei settled liefern. Mehr ist nicht nötig.

Callback-Handler · Node
// roher Body, vor dem Parsen des JSON:
// die Signatur wird über die Bytes gebildet
const expected = createHmac('sha256', secret)
  .update(`${timestamp}.${rawBody}`)
  .digest('hex');

if (!timingSafeEqual(a, b)) return res.sendStatus(401);

markOrderPaid(event.paymentId, event.creditedAmount);
res.sendStatus(200);
  • Signatur — HMAC-SHA256 von {timestamp}.{Body}, Header X-Priem-Timestamp und X-Priem-Signature.
  • Wiederholungen — sieben Versuche über anderthalb Tage: nach einer Minute, 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden und einem Tag.
  • Abfrage — GET /v1/payments/{id} liefert immer den aktuellen Status. Sich allein auf den Callback zu verlassen, taugt nicht.

Zahlungsstatus

  • createdAngelegt, Münze noch nicht gewählt
  • awaiting_paymentMünze gewählt, Überweisung steht aus
  • onramp_pendingZahlt per Karte, wir kaufen Krypto
  • detectedÜberweisung im Netz sichtbar
  • confirmingBestätigungen sammeln sich
  • convertingTausch in Ihre Währung
  • settledGeld ist auf Ihrem Guthaben
  • underpaidWeniger als nötig eingegangen
  • expiredDie Frist der Rechnung lief ab
  • refundedAn den Käufer zurückgezahlt

Liefern Sie bei settled und nur dabei.

04 / Verlässlichkeit

Was passiert, während Sie verkaufen

Die Arbeit, die man vom Konto aus nicht sieht und an deren Fehlen man Geld verliert.

Nächtlicher Abgleich

Jede Nacht stellen wir alles, was wir Händlern schulden, dem gegenüber, was tatsächlich beim Anbieter liegt. Eine Unterdeckung stoppt Auszahlungen automatisch — bis zur Klärung, nicht bis zum Morgen.

Ein Tag für Auszahlungsadressen

Eine neue Wallet-Adresse wird einen Tag nach dem Hinzufügen nutzbar. Das ist das Einzige, was zwischen einem gekaperten Konto und einem leeren Guthaben steht. Es stört genau einmal.

Unterzahlung auf unsere Kosten

Der Kurs zuckte, die Wallet behielt ihren Teil — es kam etwas weniger an. Innerhalb der Toleranz (standardmäßig 1%) schließt die Zahlung trotzdem, und Sie erhalten den vollen Preis des Schildes. Die Differenz übernehmen wir.

Protokoll und Sperre

Anmeldungen, Schlüssel, Adressen, Auszahlungen und Preisschilder landen in einem Protokoll, geordnet nach fortlaufender Nummer. Fünf Fehlversuche bei der Anmeldung sperren das Konto für fünfzehn Minuten.

05 / Bevor Sie sich entscheiden

Was Sie vorher wissen sollten

Die Annahme startet nicht sofort
Das Konto öffnet im Moment der Registrierung, aber Zahlungen annehmen können Sie erst nach einer Prüfung des Geschäfts — sie dauert ab einigen Stunden. Das ist keine Bürokratie: das Geld Ihrer Kunden läuft über unser Konto beim Anbieter, und dafür geradezustehen, wer über uns handelt, bleibt an uns hängen. Projekt, Schlüssel, Callback und Preisschilder können Sie sofort einrichten; die Annahme schaltet sich von selbst frei, ohne Ihr Zutun.
Das Netz zur Auszahlungsadresse ist Pflicht
USDT auf TRON und USDT auf BSC sind verschiedene Adressen. Ein Versand ins falsche Netz verliert das Geld endgültig, und zurückholen kann es niemand.
Machen Sie die erste echte Zahlung über 20–30 $
Nicht über zwei Dollar: bei dieser Größe legt die Netzgebühr rund vierzig Prozent drauf, und Sie halten alles für kaputt. Es ist nichts kaputt — eine feste Gebühr auf eine winzige Bestellung sieht schlicht absurd aus.
Der API-Schlüssel wird einmal gezeigt
Es gibt keinen Ort, ihn wiederherzustellen — nur einen neuen ausstellen und den alten widerrufen. Halten Sie ihn auf dem Server: im Browser legt man damit Zahlungen in Ihrem Namen an.
Konto und Dokumentation sind auf Russisch
Diese Seite ist übersetzt; Konto, Kasse und Dokumentation sind bislang nur auf Russisch. Wenn das im Weg steht, sagen Sie es uns beim Anschluss — wir ordnen die Übersetzungsreihenfolge danach, wen sie aufhält.

Priem.
Hören Sie mich?

Die Registrierung dauert eine Minute, die Einrichtung etwa eine halbe Stunde, und fast die ganze Zeit geht in den Callback-Handler.

Loslegen Dokumentation lesen