For AI agents: the complete documentation index is at /llms.txt, and the full text of every page is at /llms-full.txt. Most pages are also available as Markdown by adding .md to the URL.

Error Handling

Existing customers: Get your sandbox and production credentials for Heartland/Portico integration.

Prerequisite

Install the SDK in your IDE and set up your authentication.

Our error handler can correct many of the issues that can cause your application to fail.

Each of our SDKs handle the following error types they inherit from ApiException:

Error type	Meaning
`BuilderException`	Handle builder validation issues
`ConfigurationException`	Handle cases when the service or gateway is configured incorrectly
`GatewayException`	Handle gateway-related exceptions: invalid credit card number, gateway-timeout, etc.
`UnsupportedTransactionException`	Handle cases when the configured transaction isn’t supported by the gateway, payment method, etc.

Error handler

Explore more

Build more capabilities into your app

Get documentation and code examples for building other popular features into your application

Build in a different language

Explore the other languages you can build with using our SDKs

Developer support

We’re here to help. Contact us if you have any questions or need assistance

Error Handling | Global Payments

Policies

Connect

Additional Resources