# API · Crear URL de afiliación individual

> Crear URL de afiliación individual: POST /api/v1/collect/set/urlaffiliate.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-10-20
- url: https://tilopay.com/developers/api/cobros-tarjetas-guardadas/set-url-affiliate

```http
POST /api/v1/collect/set/urlaffiliate
```

## Qué hace [#que-hace]

Crear URL de afiliación individual.

## Autenticación [#autenticacion]

Servidor: `https://app.tilopay.com`. Requiere el token bearer del API en `Authorization: Bearer <token>` y la llave de la integración en el cuerpo (`key`).

[Obtener el token del API](/developers/api/autenticacion/token-api).

## Parámetros [#parametros]

<Param id="set-url-affiliate-parametro-key" name="key" type="string" required>
Llave de la integración.
</Param>

<Param id="set-url-affiliate-parametro-name" name="name" type="string">
Nombre del enlace.
</Param>

<Param id="set-url-affiliate-parametro-currency" name="currency" type="string">
Moneda ISO 4217.
</Param>

<Param id="set-url-affiliate-parametro-base_amount" name="base_amount" type="string">
Monto base.
</Param>

<Param id="set-url-affiliate-parametro-amount_max_daily" name="amount_max_daily" type="string">
Monto máximo diario.
</Param>

<Param id="set-url-affiliate-parametro-amount_max_month" name="amount_max_month" type="string">
Monto máximo mensual.
</Param>

## Ejemplo de request [#ejemplo-request]

`<api_key>` es el marcador de tu llave de integración.

```json
{
  "key": "<api_key>",
  "name": "Name link",
  "currency": "USD",
  "base_amount": "5.00",
  "amount_max_daily": "10.00",
  "amount_max_month": "100.00"
}
```

## Respuesta [#respuesta]

link es la URL donde el cliente registra su tarjeta.

<Param id="set-url-affiliate-respuesta-type" name="type" type="unknown">
`type`.
</Param>

<Param id="set-url-affiliate-respuesta-errors" name="errors" type="unknown">
`errors`.
</Param>

<Param id="set-url-affiliate-respuesta-link" name="link" type="unknown">
`link`.
</Param>

```json
{
  "type": "200",
  "errors": "",
  "link": "https://app.tilopay.com/link/TWc9PXw0"
}
```

```schema
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "errors": {
      "type": "string"
    },
    "link": {
      "type": "string"
    }
  }
}
```