Jeder andere Zahlungsanbieter, über die Payments API.

01Was Tally erfasst

• Ein Verkauf von jedem Anbieter, von dem dein Server erfährt, etwa Gumroad, FastSpring, Dodo Payments, Creem, PayPal oder deiner eigenen Abrechnung, gesendet mit dem Betrag in der Haupteinheit der Währung, der Währung und einer transaction_id.
• Verlängerungen: Mit renewal auf true und einer subscription_id oder customer_id folgt die Zahlung der ersten Abo-Zahlung und behält deren Quelle.
• Erstattungen: Mit refunded auf true wird die Zahlung, die die transaction_id nennt, um den gesendeten Betrag zurückgenommen; jede Teilerstattung bekommt eine eigene refund_id.
• Steuer, wenn du sie mitsendest, wird vom Betrag abgezogen; der Rest wird zum Kurs der Europäischen Zentralbank am Tag der Zahlung in US-Cent umgerechnet.
• Eine transaction_id, die die Website schon erfasst hat, ist ein Duplikat, eine doppelt gesendete Zahlung zählt also einmal.
• Ein Zeitstempel datiert die Zahlung, so zählt eine früher eingenommene an ihrem eigenen Tag.

02Wie ein Verkauf seinen Besuch findet

• Besucher-IDSende das _tally_vid-Cookie des Käufers als tally_visitor_id (datafast_visitor_id und visitor_id gehen auch), und die Zahlung wird mit diesem Besucher verknüpft. Hohe Sicherheit.
• E-MailSende email oder customer_email, und die Adresse wird sofort gehasht, um mit einem tally('identify')-Aufruf auf deiner Website abgeglichen zu werden. Mittlere Sicherheit. Ein Name wird angenommen und nie gespeichert.
• Verlängerungen und ErstattungenEine Verlängerung übernimmt die Verknüpfung der ersten Zahlung ihres Abos; eine Erstattung die der Zahlung, die sie rückgängig macht.

03Was es nicht lesen kann

04Zahlungen senden

1. Erstelle auf der Seite „Setup“ deiner Website einen API-Schlüssel und setze den Haken bei „Record payments“. Ein Schlüssel ohne diesen Haken liest nur, und ein POST damit wird mit 403 abgelehnt.
2. Wo dein Server eine Zahlung erfasst, sende sie an /api/v1/payments, mit dem Schlüssel als Bearer-Token: amount, currency, transaction_id und die Besucher-ID oder E-Mail des Käufers.
3. Lies die Besucher-ID aus dem _tally_vid-Cookie der Anfrage, die den Kauf abschließt, oder reiche sie von der Seite an deinen Checkout weiter.
4. Die Antwort sagt, ob die Zahlung erfasst wurde oder schon erfasst war; ein Body, der keine Zahlung ist, bekommt eine 400 mit einem Satz, der den Grund nennt.
5. Gesendete Zahlungen erscheinen auf der Seite „Integrations“ als Payments API, und jede wird binnen weniger Sekunden mit ihrem Besuch verknüpft.

Eine Zahlung, gesendet mit cURL

curl https://tallybyoutpost.com/api/v1/payments \
  -H "Authorization: Bearer $TALLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 29.99, "currency": "USD", "transaction_id": "order_1042",
       "tally_visitor_id": "the _tally_vid cookie", "email": "buyer@example.com"}'

05Fragen

• Ich wechsle von DataFast. Muss ich meinen Zahlungscode ändern?

  Nur die Adresse und den Schlüssel. Pfad und Body von DataFast funktionieren unverändert, samt amount, currency, transaction_id, datafast_visitor_id, email, renewal und refunded, und der Parameter websiteId wird ignoriert, da der Schlüssel die Website bestimmt.

• Von welchen Anbietern kann ich Zahlungen senden?

  Jede Zahlung, die dein Server erfasst: Gumroad, FastSpring, Dodo Payments, Creem, PayPal, Rechnungen, die deine eigene Abrechnung als bezahlt markiert. Erfährt dein Server von der Zahlung, per Webhook oder über den eigenen Checkout, kann er sie senden.

• Kann ich Zahlungen von vor meinem Start senden?

  Ja. Sende jede mit ihrem Zeitstempel, dann zählt sie an ihrem eigenen Tag; ein Zeitstempel in der Zukunft wird abgelehnt. Von selbst kommt nichts an, die Historie ist also das, was du sendest.

• Was, wenn mein Server dieselbe Zahlung zweimal sendet?

  Der zweite POST wird als Duplikat beantwortet, und nichts Neues wird erfasst, weil transaction_id die Zahlung innerhalb der Website identifiziert. Ein erneuter Versuch nach einem Timeout ist sicher.