MakePay VirtueMart-Plugin

Überblick

Das MakePay VirtueMart-Plugin fügt Joomla eine gehostete Krypto-Zahlungsmethode hinzu Geschäfte, die VirtueMart verwenden. Kunden wählen an der Kasse MakePay aus und zahlen sofort MakePay-Checkout-Seite und kehren Sie zum Geschäft zurück, während VirtueMart die Bestellung aufrechterhält aufzeichnen.

Signierte Zahlungsbenachrichtigungen aktualisieren die VirtueMart-Bestellung nach der Zahlung, sodass die Das Filialteam kann weiterhin Bestellungen in VirtueMart verwalten.

Bevor Sie beginnen

• Joomla mit installiertem VirtueMart
• PHP 7.4 oder neuer mit aktiviertem OpenSSL und cURL
• Eine öffentliche HTTPS-Storefront-URL
• Zugriff auf die Installation der Joomla-Erweiterung und die Zahlungsmethoden von VirtueMart
• Ein MakePay-Unternehmen mit konfigurierter Abrechnung und Branding

Installieren Sie das Plugin

Laden Sie die neueste ZIP-Datei herunter:

https://plugins.makecrypto.io/downloads/virtuemart/latest.zip

Öffnen Sie in Joomla System > Erweiterungen, laden Sie die ZIP-Datei hoch und aktivieren Sie sie VM Payment – ​​MakePay Crypto Payment Gateway aus dem Plugin-Manager.

Öffnen Sie in VirtueMart Zahlungsmethoden, erstellen Sie eine Zahlungsmethode und wählen Sie die aus MakePay-Zahlungs-Plugin und speichern Sie es einmal, damit VirtueMart eine Zahlungsmethode zuweist AUSWEIS.

Schließen Sie MakePay an

Öffnen Sie nach dem Speichern der Zahlungsmethode die Verbindungs-URL in der Storefront. Ersetzen Sie PAYMENT_METHOD_ID durch die ID der VirtueMart-Zahlungsmethode:

https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID

MakePay fordert Sie auf, sich anzumelden, das Unternehmen auszuwählen, das Zahlungen erhalten soll, und genehmigen Sie die Verbindung. Nach der Freigabe speichert das Plugin die Verbindung diese VirtueMart-Zahlungsmethode und konfiguriert die Rückruf-URL MakePay.

Gateway-Einstellungen

Überprüfen Sie diese Felder, bevor Sie die Zahlungsmethode öffentlich aktivieren:

Einstellung	Zweck
Verbindungsmethode	Verwenden Sie Connect MakePay für die normale Einrichtung oder manuelle API-Schlüssel als Fallback
MakePay Firmen-ID	Wird nach der Verbindung ausgefüllt oder für den Fallback manuell eingegeben
Abrechnungswährung	Bevorzugter Abrechnungsgegenstand, z. B. USDT
Zahlungsablauf	Wie lange bleibt der gehostete Checkout-Link zahlbar?
Webhook-Geheimnis	Wird zur Überprüfung von MakePay-Zahlungsbenachrichtigungen verwendet
Bestellstatus	VirtueMart-Status für ausstehende, bezahlte, fehlgeschlagene, abgelaufene, stornierte und zurückerstattete Zahlungen

Checkout-Ablauf

Wenn ein Käufer MakePay auswählt, erstellt das Plugin einen MakePay-Zahlungslink mit:

Feld	Zweck
source=virtuemart	Identifiziert die Integration
orderId=virtuemart_order_<id>	Ordnet die MakePay-Aktivität zurück zu VirtueMart
orderNumber	VirtueMart-Bestellnummer, die dem Händler angezeigt wird
pluginVersion	Installierte MakePay-Plugin-Version
virtuemartVersion	VirtueMart-Laufzeitversion, sofern verfügbar

Der Käufer wird zum gehosteten Checkout weitergeleitet. MakePay sendet dann eine signierte Nachricht Benachrichtigung an den Plugin-Benachrichtigungsendpunkt von VirtueMart.

Bestellstaaten

MakePay-Status	VirtueMart-Verhalten
paid, completed, confirmed, succeeded	Verschiebt die Bestellung in den konfigurierten bezahlten Status
expired	Verschiebt die Bestellung in den konfigurierten abgelaufenen Status
failed	Verschiebt die Bestellung in den konfigurierten Status „Fehlgeschlagen“.
cancelled, canceled	Verschiebt die Bestellung in den konfigurierten stornierten Status
refunded	Verschiebt die Bestellung in den konfigurierten Rückerstattungsstatus
Andere Status	Wird ignoriert, bis ein endgültiger Zahlungsstatus eintrifft

Bei jeder Aktualisierung wird ein privater Bestellkommentar mit der Transaktion MakePay, dem Betrag, Asset und Zahlungs-URL, sofern diese Felder vorhanden sind.

Manueller API-Key-Fallback

Wenn der Verbindungsfluss nicht verwendet werden kann, legen Sie Verbindungsmethode auf Manuelle API fest key fallback und geben Sie ein:

• MakePay Firmen-ID
• API-Schlüssel-ID
• API-Schlüsselgeheimnis
• Webhook-Geheimnis

Verwenden Sie dies nur bei Bedarf und beschränken Sie den Joomla-Administratorzugriff auf vertrauenswürdige Betreiber.

Fehlerbehebung

Wenn der Checkout nicht gestartet werden kann, vergewissern Sie sich, dass die Zahlungsmethode mit dem Unternehmen verknüpft ist oder manuelle API-Schlüsseleinstellungen. Wenn die Verbindungs-URL fehlschlägt, bestätigen Sie die Storefront ist öffentliches HTTPS und der Wert pm verweist auf die gespeicherte Zahlungsmethode MakePay.

Wenn Bestellungen nicht aktualisiert werden, vergleichen Sie die Rückruf-URL MakePay mit der von VirtueMart Plugin-Benachrichtigungs-URL und rotieren Sie das Webhook-Geheimnis aus der Zahlungsmethode Einstellungen.