# UPSTREAM_UNAVAILABLE — 502 Bad Gateway

# 502 Bad Gateway

The Gett gateway received an invalid or unexpected response from an upstream service (e.g., a provider POS system or third-party integration).

## Category

`availability`

## Retryable?

**Yes.** Retry with exponential backoff: 1s, 2s, 4s, up to a maximum of 30s. If the error persists, contact support with the `requestId`.

## Common Causes

- A restaurant's POS system returned an unrecognized response
- An upstream integration service is temporarily degraded
- Network timeout between Gett and an external provider

## Example

```json
{
  "type": "https://developer.gett-tech.com/errors/UPSTREAM_UNAVAILABLE",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "An upstream service returned an invalid response.",
  "instance": "/v1/marketfront/orders/place",
  "requestId": "req_abc123",
  "timestamp": "2026-03-11T14:30:00.000Z",
  "errorCode": "UPSTREAM_UNAVAILABLE",
  "errorCategory": "availability",
  "retryable": true
}
```