Status update endpoint is used to reconcile PIX transactions faster than our default polling.
This API is currently only available for PIX payment method.
Once a PIX Payment or Payout is created, its status will be in pending state until it's been cleared by the Central Bank of Brazil.
Our system issues polling requests for status check every 30 seconds for up to 3-5 times. Then it's followed with a 10 minutely check.
However, this timings may be too slow for your checkout or shop needs.
Thus, you should start sending POST requests to rest/status_update endpoint every 5 to 10 seconds if you would like to have faster reconciliation times.
Please, bear in mind that minimum allowed interval is 5 seconds as we have rate limiting(12 requests per minute) in place for each transaction.
Once the transaction has reached the final completed, declined or an error state, you should stop sending polling requests.
Response for this endpoint will be the same as a postback notification, which will indicate the transaction's up to date status.