Zahlungslinks decken viele Verkäufe ab, doch irgendwann braucht Ihr Unternehmen mehr: direkt auf der Website, in der App oder aus dem ERP kassieren – ganz ohne Kopieren und Einfügen. Genau hier kommt die Zahlungs-API ins Spiel.
Was ist eine Zahlungs-API?
Eine API (Programmierschnittstelle) ist der Kommunikationskanal zwischen Ihrem System und der Zahlungsplattform. Darüber legt Ihre Software Zahlungen an, verfolgt deren Status und erhält Bestätigungen automatisch – per HTTP-Requests mit Daten im JSON-Format.
So funktioniert die Integration – Schritt für Schritt
- Konto eröffnen und Schlüssel erzeugen: Im Sila-Pay-Dashboard erzeugt das Menü API Key Ihren api-key und Ihren secret-key, die im Header jedes Requests mitgesendet werden.
- Zahlung anlegen: Ihr System sendet einen POST an https://api.silapay.pro/v1/transactions mit Betrag, Kundendaten und Zahlungsart (pix, creditCard oder billet).
- Zahlung anzeigen: Bei Pix enthält die Antwort den Copy-and-paste-Code; beim Boleto wird die Zahlung mit dem festgelegten Fälligkeitsdatum ausgestellt; bei der Karte erhalten Sie das Ergebnis der Transaktion.
- Bestätigung erhalten: Geben Sie eine postbackUrl an, und Ihr System wird per Webhook informiert, sobald sich der Zahlungsstatus ändert.
Pix, Karte und Boleto: die Unterschiede
- Pix: Die Zahlung wird mit dem Status „ausstehend“ und einem Copy-and-paste-Code angelegt; die Bestätigung kommt per Webhook, sobald die Zahlung erkannt wird.
- Kreditkarte: Ratenzahlung ist möglich – die Anzahl der Raten geben Sie im Request an –, und die Kundschaft kann auf eine Erfolgsseite (successUrl) weitergeleitet werden.
- Boleto: Sie legen das Fälligkeitsdatum fest und können eine eigene Referenz (externalReference) mitsenden, um die Zahlung der Bestellung zuzuordnen.
Vorteile der Integration per API
- Sie gestalten das Erlebnis: Sie entscheiden, wo und wie die Zahlung angezeigt wird.
- Weniger Handarbeit: Bestellungen werden automatisch angelegt und bestätigt.
- Eine Integration, drei Zahlungsarten: Pix, Karte und Boleto über denselben Endpoint.
- Wächst mit Ihrem Unternehmen: Derselbe Ablauf funktioniert für wenige wie für viele Bestellungen pro Tag.
Möchten Sie Zahlungen in Ihr System integrieren? Jetzt Sila-Pay-Konto eröffnen
Best Practices für die Integration
- Schlüssel nur auf dem Server: Legen Sie api-key und secret-key niemals im Frontend oder in der App ab; die Aufrufe müssen aus Ihrem Backend kommen.
- Webhooks prüfen: Kontrollieren Sie den Header X-Silapay-Signature, bevor Sie eine Bestellung als bezahlt markieren.
- Transaktions-ID speichern: Verknüpfen Sie die von der API zurückgegebene id mit der Bestellung in Ihrem System.
- Fehler und Timeouts behandeln: Zeigen Sie eine verständliche Meldung und ermöglichen Sie einen neuen Versuch, ohne doppelte Zahlungen anzulegen.
- Mit kleinen Beträgen starten: Testen Sie den gesamten Ablauf, bevor Sie ihn für alle Kunden freigeben.
Häufige Fragen
Brauche ich einen Entwickler?
Für die Integration per API ja: Jemand muss die Aufrufe in Ihrem System programmieren. Wenn Sie WooCommerce oder Shopify nutzen, sind die Sila-Pay-Plugins der einfachere Weg; und ohne Website genügt oft ein Zahlungslink.
Wo finde ich die Dokumentation?
Unter doc.silapay.pro – mit den Aufrufen für Pix, Karte, Boleto, Kontostand und Webhooks sowie Beispielen für Requests und Responses.
Dient die API nur zum Kassieren?
Nein. Neben dem Anlegen von Zahlungen beschreibt die Dokumentation auch das Senden von Pix (Cash-out) und die Abfrage des Kontostands.
Brauche ich ein brasilianisches Unternehmen (CNPJ)?
Mit Sila Pay können Sie als Privatperson oder als Unternehmen verkaufen; bei der Registrierung sehen Sie, welche Unterlagen jeweils nötig sind.
Integrieren Sie Pix, Karte und Boleto mit einer einzigen API. Bei Sila Pay registrieren