This feature needs to be unlocked for your account. If you are interested, please contact support@billwerk.com.


billwerk offers the possibility of redeeming prepaid cards purchased via stationary retail trade and to charge an account with the prepaid card amount. This function includes an integration with the provider epay.



  1. To set up the feature, go to 'Settings - 3rd Party Integrations' and click the Edit icon in the Epay section.

  2. Select the mode (Test/Live) and enter your user name and password.

  3. Then switch to the 'Prepaid Card Profiles' tab. Click on 'Add profile' and fill in the following information:
    Internal Name - Internal name of a card
    EAN - European Article Number
    Tax Country - Select a country from the list
    Tax Percentage - Set a tax rate
  4. After the data is entered, the status of the payment method will switch to OK. Use the checkbox to select the payment method and therefore complete the configuration.


Adding a prepaid card to the contract:

You can add a prepaid card to a contract via REST API using the POST method.

Method: POST
Endpoint: /api/v1/PrepaidCards/Redeem

  "SecretCode": "xxx",
  "ContractId": "xxx",
  "Provider": "Epay",

Mandatory fields:
SecretCode = Secret code of the prepaid card
ContractId = Contract ID of an existing contract
Provider = Provider name

Where can I find information about the added prepaid card?

Use the following API call to get information about prepaid cards added to the contract.

Method: GET
Endpoint: /api/v1/Contracts/{ContractId}/PrepaidCards

All relevant information about the prepaid card (original / remaining amount) can also be found in the UI in the contract details under the tab 'Prepaid cards': 

Was this article helpful?
0 out of 0 found this helpful