lighthouse.dock.tech

Welcome to Lighthouse!

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

Get Started

Unexpected Negative Balances

There are some unexpected reasons why an end-user may end up with a negative balance in the payment account. These types of transactions are foreseen in the Payment Arrangement rules (Dock receives the amounts in the Base II file from the Card Scheme, which has a maximum authority).

Differences in the Purchase Amount and Exchange Rate


It occurs due to differences between the moment of the Authorization (Base I) and the moment of the Settlement (Base II). See the example below:

An end-user with a balance of BRL 1,185.00 makes a purchase of USD 200.00 on a specific date, being the exchange rate at BRL 5.55 (Spread at 4% included). The purchase's final amount that will appear in the Base I file would be BRL 1,180.82 (BRL 1.110,00 from the Purchase plus IOF of BRL 70.82).

If at the moment of Processing Base II, the purchase destination amount is different from Base I, a new transaction is registered. The Purchase amount of Base I is reversed. Suppose the new purchase amount at Base II is USD 201.00 (due to unforeseen expenses such as packing, freight, etc.) and the new exchange rate at the moment of Processing Base II is R$5,78 (Spread at 4% included).

The new final purchase amount will be BRL 1,232.60 (the purchase of BRL 1,161.78 and the same IOF of BRL 70.82, Base I is the one considered for taxes). Therefore, as the end-user initially had R$1,185.00, the account ends up with a negative balance of BRL -47.60.

See table below:

Amount on Authorization Date or Base I (USD 1 = BRL 5.55)

Amount on Settlement Date or Base II (USD 1 = BRL 5.78)

Initial Account Balance

BRL 1,185.00

BRL 1,185.00

Purchase Amount

USD 200.00

USD 201.00

Exchanged Amount (included 4% spread)

BRL 1,110.00

BRL 1,161.78

IOF (6.38%)

BRL 70.82

BRL 70.82

Final Amount

BRL 1,182.82

BRL 1,232.60

Final Account Balance

BRL 4.18

BRL -47.60

Offline Transaction


They are purchases on a flight, on the subway or buses, on toll road charges, or in regions with a weak wireless signal coverage, where there is no balance check at the time of Authorization (Base I).

Later Settlement


This scenario generally occurs when a purchase confirmation takes longer to be received in Base II. Then, Status 20 is assigned.

Status 20 is "Baixado por Prazo", i.e. written-off as an overdue transaction, which means the transaction is reversed because the deadline is past due. It can be assigned to a purchase transaction and its amount will be returned to the end-user. This reversal will occur a few days later, counting as of the transaction date:

  • For Visa Cards: It will be 7 days after the purchase date;
  • For MasterCard and ELO cards: It will be 30 days after the purchase date.

Later on, if the end-user uses this balance for any other transaction, a few days later the transaction confirmation is received and posted to the account. At this time, there is a possibility that the account may not have enough funds and it may result in a negative balance.

In any case, if necessary, the end-user may open a dispute form (chargeback). Click here for more details.

Updated 2 months ago


Unexpected Negative Balances


Suggested Edits are limited on API Reference Pages

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