Skip to main content

​
Top up a wallet

There are 3 ways funds can be added to a customer’s wallet:
  1. You can top up through Hyperline yourself (after discussing with your customer and agreeing on an amount)
  2. Customers can top up their account themselves through their customer portal
  3. The wallet can be topped up through the API
Paid top-ups are funds your customer pays for, acting as a prepayment. Free top-ups are an offer you are making to the customer (the funds are added for free). Paid top-ups are funds your customer pays for, acting as a prepayment. When processed with an automated payment method on Hyperline (card, direct debit, etc.), a confirmation receipt is generated and sent by email to the customer as a PDF. This document has no accounting impact and is purely informational.

​
Free top-ups

Free top-ups are an offer you are making to the customer (the funds will be added for free). When adding free funds to the wallet, a corresponding credit note is generated for accounting purposes.

​
From the customer portal

You can let your customers top up independently 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 choose how much they want to add to their wallet

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

Customer wallets are automatically debited when the feature is enabled in the wallet settings and the wallet has a positive balance. Wallet funds are used to pay subscriptions, related invoices, and one-time payments. A wallet cannot have a negative balance. Hyperline automatically deducts the maximum possible amount from the wallet when paying invoices. Any remaining amount is charged to the customer’s default payment method. An invoice can combine multiple payment sources (e.g. wallet + credit card), and this breakdown is displayed on the 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.