epay

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

1. Um die Funktion einzurichten, klicken Sie unter 'Einstellungen > Drittanbieterintegrationen' auf das -Symbol im Epay-Abschnitt.
   
   
2. Wählen Sie den Modus (Test/Live) und geben Sie Ihren Benutzernamen und Ihr Passwort ein.
   
3. 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
4. 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':