Skip to main content

​
Top-up a wallet

There are 3 ways funds can be added to a customer’s wallet:
  1. You can either top-up through Hyperline yourself (after discussing with your customer and agreeing on an amount)
  2. Customers can also top-up their account themselves through their customer portal
  3. The wallet can be topped-up through the API
Paid top-up are funds your customer pays for, acting as a prepayment. Free top-up are an offer you are making to the customer (the funds will be added for free).
Paid top-ups generate a confirmation receipt. The related PDF is sent by email to the customer.

​
Top-up from the customer portal

You can make your customers autonomous by offering them to top-up through their portal.
1

Make sure you enabled the option

For this, you have to go to the wallet settings first.
Top-up limitationsIt is currently not possible to add more than $100 in one payment to a wallet, and the total balance of a wallet can’t be more than $500 for payments made through a customer portal.Paid top-ups added through Hyperline have no limitations.
2

Your customers are now able to top-up from their portal

They will be required to add a credit card as a payment method to do so.
3

Your customers must choose how much they want to top-up their wallet with

Clicking on Top-up on this screen will trigger an immediate payment from the registered credit card and credit the wallets instantly.
4

The corresponding invoice is now created and visible on the portal

Invoices can be downloaded as PDF by the customer.

​
Wallet debit

Customers wallets are automatically debited when the feature is enabled (wallet settings configured) and if there is money on it. They are used to pay subscriptions, related invoices and one-time payments. A wallet cannot have a negative balance. We make sure to take the maximum amount of money from wallets when paying invoices, but the potential remaining part to pay will be processed with the default customer payment method (the one saved). An invoice can have multiple debit methods, e.g. wallet + credit card, and this will be displayed on the final generated PDF invoice.

​
Revert a wallet transaction

You can revert wallet top-up transactions to remove funds that were previously added to a customer’s wallet.
Only top-up transactions (credit transactions) can be reverted. Debit transactions (consumption) cannot be reverted.

​
How it works

When you revert a wallet transaction:
  • The credited amount is deducted from the current wallet balance
  • If the transaction was a free top-up, the related credit note is voided
  • If the transaction was a paid top-up, the amount is deducted from the wallet balance. If you need to refund the initial banking transaction, this must be done outside of Hyperline

​
Requirements

A transaction can only be reverted if:
  • It is a top-up transaction (not a debit/consumption transaction)
  • It has not already been reverted
  • The wallet has sufficient balance to cover the reversal amount
Make sure the wallet balance is sufficient before reverting a transaction. If the balance is too low, the revert action will fail.

​
Wallet balance & projection

Wallet balances are computed in real time in Hyperline. In addition to the wallet balance, we also compute and return a projected balance. This balance takes into account a projection of the future remaining money on the wallet after paying what will be due in the current period (subscription, usage). This is particularly useful for a pay-as-you-go use case when you want to restrict access to your product if the customer doesn’t have enough funds in their wallet.