# Errors

```json
{
  "code": 422,
  "status": "failed",
  "client_transaction_id": "id-forgery-001",
  "message": "invalid image type image"
}
```

| HTTP status | Meaning | Common messages |
| --- | --- | --- |
| `400` | A provider, billing, or usage request could not be completed. | `access timeout` |
| `401` | Basic credentials, merchant key, Bearer token, timestamp, or signature could not be authenticated. | `invalid authorization`, `invalid merchant key`, `authentication failed`, `invalid token`, `invalid timestamp`, `invalid signature` |
| `403` | The integration cannot use this service or has insufficient balance. | `forbidden`, `insufficient balance` |
| `422` | The JSON payload, channel, transaction ID, or submitted image is invalid. | See validation messages below. |
| `503` | The service is under maintenance. | `service is currently under maintenance` |

Validation returns HTTP `422` with:

- `empty transaction_id`
- `transaction_id length must be between 1 and 36`
- `invalid transaction_id`
- `empty image`
- `invalid base64 image`
- `image above image size requirement`
- `invalid image type image`
- `channel length must be between 1 and 100`
- `invalid channel`