# Adherirme al programa (https://docs.loybox.com.ar/api-reference/mi-cuenta/adherirme)



<Endpoint method="POST" path="/v1/me/subscription" auth="user-token" />

Adhiere al usuario al programa de fidelidad del comercio. Si el comercio
configuró una recompensa de bienvenida, se devuelve en `welcome_benefit` o
`welcome_points`.

<Callout type="info" title="Verificar el código ya adhiere al usuario">
  [Verificar un código](https://docs.loybox.com.ar/api-reference/autenticacion/verificar-codigo) ya deja al
  usuario adherido, así que este endpoint sirve **sobre todo para volver a
  adherirse después de una baja**.
</Callout>

## Headers [#headers]

<Fields>
  <Field name="X-Commerce-Id" type="integer" location="header" required="true">
    Id del comercio que integra la API. Todas las respuestas quedan limitadas a
    este comercio.
  </Field>
</Fields>

No lleva cuerpo.

## Respuesta [#respuesta]

<Fields>
  <Field name="message" type="string" required="true">
    Resultado de la operación.
  </Field>

  <Field name="welcome_benefit" type="Beneficio | null">
    Beneficio de bienvenida, si el comercio configuró uno y el usuario recién se
    adhirió. Ver [Beneficio](https://docs.loybox.com.ar/api-reference/objetos#beneficio).
  </Field>

  <Field name="welcome_points" type="integer | null">
    Puntos de bienvenida, si el comercio configuró puntos en vez de un beneficio.
  </Field>
</Fields>

```bash
curl -X POST https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me/subscription \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Commerce-Id: 87"
```

```json
// 200 OK
{
  "message": "Subscribed successfully",
  "welcome_benefit": {
    "id": "b_4c81",
    "type": "free_product",
    "description": "Café de regalo",
    "cost": 0,
    "expiration": null,
    "benefit_type": "welcome",
    "color": "#f1a10d",
    "buy_limit": 1,
    "prize": null,
    "tiendanube_coupon": null
  },
  "welcome_points": null
}
```

Los dos campos de bienvenida son excluyentes: viene uno o el otro, según lo que
el comercio haya configurado. Si no configuró nada, vienen los dos en `null`.

Es un buen momento para mostrar una pantalla de bienvenida: si vino
`welcome_benefit`, el premio; si vino `welcome_points`, los puntos que acaba de
ganar.

## Errores [#errores]

| Código | Cuándo                                                                |
| ------ | --------------------------------------------------------------------- |
| `401`  | El token de acceso falta, venció o no corresponde a un usuario final. |
| `404`  | El comercio no existe.                                                |
| `422`  | Falta el header `X-Commerce-Id`.                                      |