Welcome to Lighthouse!

Find comprehensive guides and documentation on our products, as well as support if stuck. Come and get started!

Get Started

Mobile Recharges

Recharges API is a product that allows to perform mobile phone recharges. The recharge is allowed for the four main dealer codes in Brazil:

  • Vivo;
  • Claro;
  • Oi;
  • TIM.


Credit SLA

Mobile phone recharges can take up to 72 hours to be credited to your phone number.


Recharge Cancellation

It is not possible to cancel the confirmed phone recharges.
We highly suggest confirming the phone number before confirming the recharge.


To recharge a mobile phone, you must follow the step-by-step below:

1) List all dealers available.

GET List Recharges Dealers

2) Request a recharge for a specific phone number associated with a specific dealer (listed in the first step). The API will return an identification code for the recharge order (orderId) and the recharge amounts available for the chosen dealer.

POST Create Recharges

3) Place a request according to the orderId and choose the recharge amount based on the available options, both returned in step 2.

POST Create Recharges Order

4) Confirm the request placed in step 3 to finish the process.

POST Create Recharges Confirm

5) It is also possible to list all mobile phone recharges done by an account and search for a specific mobile phone recharge performed.

GET List Recharges Account
GET Get Recharges Adjustment

Technical Documentation

To see the technical resources about this product, you can access our technical documentation by clicking here.



The registration of the postbacks must be requested through Zendesk informing what is the URL to receive the JSON messages. To see the available webhooks for Recharges click here.

Updated about a month ago

Mobile Recharges

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.