Skip to main content

API payments

Purpose#

The purpose of the API payment is to give you the possibility to use your personal type of payment, with all the configurations in payment you want. The configuration of the API payment must be set using the Custom Payment popup for every single chargebox.

Custom Payment

Bi-directional requests#

When you configure the API payments the flow is a bi-directional flow. Thor sends a notification of start transaction. During the charging Thor requests every n seconds the current meters of the transaction. When Thor receives it , Thor sends to your API endpoint the current meter and other transaction datas. You have to reply to Thor the amount till that moment of the charging. In the same way when you call a stop Thor send two messages to your server. In the first Thor wants to know the total amount of the transaction for the payment. In the second one Thor notify the stop to your server.

Caveats#

If your're thinking of implementing an integration with Thor, you'll probably want to hide your chargeboxes from the Thor's app. This can be done by unchecking the checkbox Show chargeboxes on Thor app in the Customization page of the administration dashboard. This is better described here.