Skip to main content

Response codes

A list of codes and messages that Tesouro returns in the response message for a payment transaction.

Error handling

Learn how to handle errors from invalid data, broken business rules, or an internal critical error.

​
Contact Tesouro

If you have any questions or encounter issues when integrating with the Tesouro API, please contact us using the shared Slack channel provided to you, or support@tesouro.com. When reporting issues, please include as much information as possible to help us troubleshoot the problem. Such as:
  • Tesouro environment (production or sandbox),
  • Exact error messages or screenshots of the errors (if applicable),
  • HTTP request data (endpoint URL, headers, body),
  • any changes made to your application or environment before the issue occurred,
  • x-request-id from the response headers.
Please also indicate the severity level in the email subject line using the [Severity] Subject format, for example: 
[High] POST /receivables started returning HTTP 500 errors

​
Severity levels

Severity level describes the level of the impact to your system. Choosing the right severity level for your support requests helps us prioritize them. Our severity levels are defined as follows:
  • Normal - Minor or no loss of service. The platform is fully usable with workarounds.
    This level is also used for feature requests, documentation clarifications, general questions and feedback.
  • High - Partial loss of service with major impact on the business. A workaround may exist, but may be inconvenient or impractical.
  • Critical - Tesouro production environment is unavailable, or there is a major malfunction that prevents the customers from using the Tesouro platform and no workaround exists. The platform is unusable until the issue is fixed.