Dieses Feature muss für Ihren Account freigeschaltet werden. Bei Interesse kontaktieren Sie bitte support@billwerk.com.
Einführung
billwerk bietet die Möglichkeit, über den stationären Einzelhandel gekaufte Guthabenkarten einzulösen und mit dem Guthabenkartenwert ein Vertragskonto aufzuladen. Diese Funktion beinhaltet eine Integration zum Anbieter epay.
Einstellungen
- Um die Funktion einzurichten, klicken Sie unter 'Einstellungen > Drittanbieterintegrationen' auf das
-Symbol im Epay-Abschnitt.
- Wählen Sie den Modus (Test/Live) und geben Sie Ihren Benutzernamen und Ihr Passwort ein.
- Wechseln Sie danach auf die Registerkarte 'Guthabenkartenprofil'. Klicken Sie dort auf 'Profil hinzufügen' und füllen Sie folgende Daten aus:
Interner Name - Interner Name einer Karte
EAN - Europäische Artikelnummer
Steuerland - Wählen Sie ein Land aus der Liste aus
Steuersatz - Legen Sie einen Steuersatz fest - Nach der validen Eingabe der Daten, wechselt der Status der Zahlungsmethode auf OK. Aktivieren Sie über das Kontrollkästchen die Zahlungsmethode und schließen damit die Konfiguration ab.
Abrechnungseinstellung für Guthabenkarten mit verbrauchtem Guthaben
Sie können in den Einstellungen unter "Zahlung > Abrechnung" definieren, welche Aktion ausgeführt werden soll, sobald das Guthaben der Guthabenkarte eines Kunden aufgebraucht ist.
- Keine Aktion: Es werden keine Änderungen vorgenommen, der Kunde kann allerdings offene Forderungen über die Guthabenkarte nicht mehr begleichen
- Beenden: Der Vertrag des Kunden wird automatisch beendet, sobald das Guthaben aufgebraucht ist
Hinzufügen einer Guthabenkarte zum Vertrag:
Sie können eine Guthabenkarte zu einem Vertrag über REST API mit der POST-Methode hinzufügen.
Methode: POST
Endpunkt: /api/v1/PrepaidCards/Redeem
Body:
{ "SecretCode": "xxx", "ContractId": "xxx", "Provider": "Epay", }
Pflichtfelder:
SecretCode = Geheimer Code der Guthabenkarte
ContractId = Vertrags-ID des bestehenden Vertrages
Provider = Provider-Name
Wo finde ich Informationen über die hinzugefügte Guthabenkarte?
Um Informationen über in den Vertrag hinzugefügte Guthabenkarten zu erhalten, verwenden Sie folgenden API-Aufruf.
Methode: GET
Endpunkt: /api/v1/Contracts/{ContractId}/PrepaidCards
Alle relevanten Informationen zur Guthabenkarte (Restbetrag, Ursprungsbetrag) finden Sie auch im UI in den Vertragsdetails unter dem Tab 'Guthabenkarten':