> **Description:** Detailed list of error scenarios, problem types, and resolution strategies for handling recurring payment issues and exceptions.

# Problems

In Recurring API, HTTP responses for errors follow the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) standard.

See [Troubleshooting errors](https://developer.vippsmobilepay.com/docs/knowledge-base/errors.md) for more details about the format.

API version: 3.0.0.

## Problem types

The `type` is the primary identifier for a problem. It is a URL to a page with more details regarding the problem.
Each problem type returned by the Recurring API starts with `https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-problems#` followed by a problem identifier.

Example: `https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-problems#invalid-agreement-id`

### Identifiers

#### `validation-error`

Missing data or inconsistencies in JSON. Please verify the request JSON body. See [API specs](https://developer.vippsmobilepay.com/redocusaurus/recurring-swagger-id.yaml).

#### `invalid-agreement-id`

Agreement ID is invalid. Please verify the agreement ID is present and in the correct format. See [API specs](https://developer.vippsmobilepay.com/redocusaurus/recurring-swagger-id.yaml).

#### `invalid-json`

JSON body is invalid. Please verify the request JSON body.

#### `unsupported-media-type`

Media type indicated in Content-type header is not supported. See [API specs](https://developer.vippsmobilepay.com/redocusaurus/recurring-swagger-id.yaml).

#### `not-authorized`

JWT token is invalid.

#### `idempotency-key-header`

Missing or invalid Idempotency key header. See [API specs](https://developer.vippsmobilepay.com/redocusaurus/recurring-swagger-id.yaml).

#### `charge-amount-too-high`

Amount set for charge is too high.

#### `charge-due-too-soon`

Charge date due must be a minimum of 2 days in the future. See [Create a charge](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md#create-a-charge).

#### `charge-due-in-too-long`

Charge due date must be a maximum of 2 years in the future. See [Create a charge](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md#create-a-charge).

#### `unsupported-feature`

Feature not supported. Please [contact us](https://developer.vippsmobilepay.com/docs/contact.md#technical-questions-about-our-apis).

#### `illegal-agreement-create`

Agreement cannot be created. Might be due to a mismatch between merchant type and agreement type.

#### `illegal-agreement-update`

Agreement cannot be updated. Might be stopped or pending.

#### `invalid-suggested-max-amount`

Suggested max amount is invalid or too high. See [Recurring agreements with variable amount](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md#variable-amount-pricing).

#### `cancel-charge-failed`

Could not cancel the charge.

#### `charge-creation-failed`

Could not create the charge.

#### `charge-capture-failed`

Could not capture the charge.

#### `missing-request-header`

Missing headers. See [API specs](https://developer.vippsmobilepay.com/redocusaurus/recurring-swagger-id.yaml).

#### `invalid-sale-unit`

The Sales unit is not allowed to use Recurring. See [update-agreement-patch-endpoint](https://developer.vippsmobilepay.com/redocusaurus/recurring-swagger-id.yaml).

#### `resource-not-found`

The specified resource was not found. See details for additional information.

#### `operation-failed`

The requested operation could not be performed. See details for additional information.

#### `conflict`

The requested operation could not be performed due to a conflicting request/state. See details for additional information.

#### `idempotency-conflict`

The specified `idempotency-key` has previously been used in a different context. See details for additional information.

#### `not-acceptable`

Media type indicated in `Accept` header is not supported.

> **Full site overview:** For every page in this documentation, read [https://developer.vippsmobilepay.com/llms.txt](https://developer.vippsmobilepay.com/llms.txt).