Balance top-ups

Add balance to the company with its payment method: it is charged first and only added if it succeeds.

  • Category: Payments and administration
  • Status: Available
  • Requirements: Being a company admin; A default payment method saved in the company
  • MCP tools: No MCP tools: it is used from the dashboard.

Markdown

What can you do with it?

  • Add credit before contracting.
  • Pay off debt and leave arrears immediately.
  • Add or change the company's payment method.

When should you use it?

When you want balance available or need to cover debt without waiting for the automatic charge. To top up automatically below a floor there is auto top-up.

How does it work in ArduMaker?

  1. An admin enters the amount, in euros with up to 2 decimals.
  2. ArduMaker charges that amount to the company's default payment method in Stripe.
  3. If the charge succeeds, the payment is recorded and the balance goes up. If services were paused for arrears, they are reactivated.
  4. If it fails, the failed attempt is recorded and nothing is added.

Balance is also used to prepay services: if it is not enough, the difference is charged to the card.

What actually changes?

A pago movement in the company history, with the charge identifier. Payments are billable movements.

Expected result

The response returns the updated balance and whether the arrears were resolved.

Errors and troubleshooting

  • 403: only a company admin can top up.
  • `amount_cantidad_is_required` or invalid amount: the amount is missing or not a positive number.
  • Charge rejected: check the payment method; retrying creates another charge, so wait for the response.

MCP access

There are no MCP tools to top up balance or touch payment methods: moving money stays with a human admin. See /mcp/docs.

Related features