Joomshopping Payments: M-Pesa

Zahlungen über M-Pesa (Safaricom) annehmen — der Kunde gibt seine Telefonnummer ein, bestätigt die Abbuchung auf seinem Telefon, und der Shop wartet selbst auf das Ergebnis.

Das Addon fügt M-Pesa als Zahlungsart in JoomShopping mit dem STK-Push-Szenario hinzu. Der Kunde wird nicht auf eine fremde Website weitergeleitet: Er gibt seine Telefonnummer direkt im Shop ein, erhält auf dem Telefon eine Aufforderung zur Zahlungsbestätigung, gibt seine PIN ein — und die Shop-Seite aktualisiert sich selbst, sobald Safaricom die Zahlung bestätigt hat. Alle Anfragen und Antworten werden in einer eigenen Shop-Tabelle gespeichert.

Funktionen

• Zahlung ohne Weiterleitung auf eine fremde Website: der Kunde gibt seine Telefonnummer auf der Shop-Seite ein
• STK Push: die Aufforderung zur Zahlungsbestätigung erreicht direkt das Telefon des Kunden
• Die Shop-Seite verfolgt den Zahlungsstatus selbst und geht zur Bestellbestätigung über, sobald die Zahlung erfolgt ist
• Automatische Umwandlung der Telefonnummer ins internationale Format — der Kunde kann sie in der gewohnten Schreibweise eingeben
• Verarbeitung des Rückrufs (IPN) von Safaricom mit Speicherung von Ergebniscode, Beschreibung und M-Pesa-Belegnummer
• Alle Transaktionen werden in einer eigenen Shop-Tabelle gespeichert: Bestellnummer, Anfragekennungen, Telefon, Betrag, Status, Belegnummer und die vollständige Antwort von Safaricom
• Automatische Statusänderung der Bestellung je nach Zahlungsergebnis: getrennte Status für erfolgreiche, ausstehende und fehlgeschlagene Zahlungen — jeweils aus der Statusliste Ihres Shops wählbar
• Bei einer Ablehnung kehrt der Kunde mit dem Fehlertext von Safaricom zur Auswahl der Zahlungsart zurück
• Wahl der Vorgangsart: Zahlung auf Paybill oder auf Buy Goods (Till)
• Alle Schritte des Austauschs mit Safaricom werden im Shop-Log paymentdata.log protokolliert
• Der Testmodus arbeitet mit der Safaricom-Sandbox — die Zahlung lässt sich vor dem Start des Shops prüfen

Einstellungen

• Testmode — Umschalten zwischen Safaricom-Sandbox und Live-Umgebung
• Consumer key — der Anwendungsschlüssel aus dem Safaricom-Entwicklerportal
• Consumer secret — das Anwendungsgeheimnis
• Business shortcode — der Code Ihrer Organisation (Paybill oder Till)
• Passkey — der Schlüssel zum Signieren der STK-Push-Anfragen
• Transaction type — die Vorgangsart: CustomerPayBillOnline oder CustomerBuyGoodsOnline
• Default country code — die standardmäßige Ländervorwahl
• Transaction end status — Bestellstatus bei erfolgreicher Zahlung
• Transaction pending status — Bestellstatus bei Zahlung in Bearbeitung
• Transaction failed status — Bestellstatus bei fehlgeschlagener Zahlung

Technische Hinweise

• Erforderlich ist ein Konto im Safaricom-Entwicklerportal (Daraja) mit einer M-Pesa-Express-Anwendung: Consumer key, Secret, Shortcode und Passkey stammen von dort
• Ihr Shop muss für die Safaricom-Server von außen über HTTPS erreichbar sein, also nicht durch ein Passwort geschützt oder per IP eingeschränkt — andernfalls trifft der Rückruf zur Zahlung nicht ein
• Beträge werden an M-Pesa als ganze Zahlen übergeben (ohne Cent)
• Auf dem Server muss die PHP-Erweiterung cURL aktiviert sein