# PAYMENT_RETURN_URL_INVALID

return_url must be an absolute https:// URL with a host (for example https://your-portal.com/return)

<Callout type="info">
**Category:** [Payment integrations](/errors/category/paymentintegration)
</Callout>

## Example response

When this error occurs, the API returns a JSON response with the following shape:

```json
{
  "type": "https://docs.beel.es/errors/PAYMENT_RETURN_URL_INVALID",
  "title": "PAYMENT_RETURN_URL_INVALID",
  "detail": "return_url must be an absolute https:// URL with a host (for example https://your-portal.com/return)",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "PAYMENT_RETURN_URL_INVALID",
    "message": "return_url must be an absolute https:// URL with a host (for example https://your-portal.com/return)",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
```

The `type` URI is stable and always resolves to this page.

## Message

<Tabs items={["English", "Spanish", "Catalan"]}>
  <Tab value="English">{"return_url must be an absolute https:// URL with a host (for example https://your-portal.com/return)"}</Tab>
  <Tab value="Spanish">{"El return_url debe ser una URL absoluta que empiece por https:// y tenga dominio (por ejemplo https://tu-portal.com/vuelta)"}</Tab>
  <Tab value="Catalan">{"El return_url ha de ser una URL absoluta que comenci per https:// i tingui domini (per exemple https://el-teu-portal.com/tornada)"}</Tab>
</Tabs>

Send the request with `Accept-Language: <es|en|ca>` to receive the message in your preferred language.

## Other errors in this category

<div className="grid grid-cols-2 gap-3 not-prose">
  <Card title="COMPANY_NOT_ACTIVATED_IN_ENVIRONMENT" description="This company is not activated in ‹value› mode. Activate it in that mode before connecting the payment provider: activation is what creates the invoice series and tax configuration that charges need" href="/errors/COMPANY_NOT_ACTIVATED_IN_ENVIRONMENT" />
  <Card title="CONNECTION_NOT_ACTIVE" description="Payment connection is not active" href="/errors/CONNECTION_NOT_ACTIVE" />
  <Card title="CONNECTION_NOT_FOUND" description="Payment connection not found" href="/errors/CONNECTION_NOT_FOUND" />
  <Card title="CONNECTION_SERIE_INACTIVE" description="The selected series is deactivated" href="/errors/CONNECTION_SERIE_INACTIVE" />
  <Card title="CONNECTION_SERIE_NOT_FOUND" description="The selected series does not exist in this company and environment" href="/errors/CONNECTION_SERIE_NOT_FOUND" />
</div>

## Keep exploring

<div className="grid grid-cols-2 gap-3 not-prose">
  <Card title="All Payment integrations errors" description="Every code in this category in one table." href="/errors/category/paymentintegration" />
  <Card title="Error reference home" description="Browse every category or jump to the handling guide." href="/errors" />
</div>

---

Full OpenAPI spec: https://docs.beel.es/api/openapi