> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Registrar conversión

> Registra una conversión asociada a un enlace corto.



## OpenAPI

````yaml /es/short-links-api/api-reference/openapi-conversions.json post /v1/conversions
openapi: 3.0.3
info:
  title: 'API Notifique: Conversiones (enlaces inteligentes)'
  description: >-
    Registra **conversiones** o pedidos atribuidos a un mensaje enviado a través
    de Notifique.


    **Autenticación:** `Authorization: Bearer sk_live_xxxxx` o `x-api-key`.


    **Alcance:** `conversions:manage`.


    Utilice el mensaje rastreado `msg_id` (Smart Link / enlace automático al
    enviar). La operación es **idempotent** por `order_id`: repetir el mismo
    orden devuelve **200** en lugar de duplicar.
  version: 1.0.0
servers:
  - url: https://api.notifique.dev
    description: Producción
security:
  - ntfConversionsBearerAuth: []
  - ntfConversionsApiKeyHeader: []
tags:
  - name: Conversions
    description: Atribución de pedidos a mensajes rastreados (`POST /v1/conversions`).
paths:
  /v1/conversions:
    post:
      tags:
        - Conversions
      summary: Registrar conversión
      description: Registra una conversión asociada a un enlace corto.
      operationId: ntfConversions_postV1Conversions
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - msg_id
                - order_id
              properties:
                msg_id:
                  type: string
                  maxLength: 128
                  description: Notifique el ID del mensaje vinculado al clic (Smart Link).
                order_id:
                  type: string
                  maxLength: 256
                  description: ID de pedido único en su sistema.
                value:
                  type: number
                  description: Importe en unidades monetarias (por ejemplo, 149,90).
                valueCents:
                  type: integer
                  description: Importe en céntimos (alternativa a `value`).
                currency:
                  type: string
                  default: BRL
                metadata:
                  type: object
                  additionalProperties: true
            example:
              msg_id: msg_abc123
              order_id: ORD-98765
              value: 149.9
              currency: BRL
      responses:
        '200':
          description: La conversión ya existía (idempotente).
        '201':
          description: Conversión creada.
        '400':
          description: Cuerpo no válido.
        '401':
          description: No autorizado.
        '403':
          description: Falta el alcance `conversions:manage`.
components:
  securitySchemes:
    ntfConversionsBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Clave API en el encabezado de autorización. Ejemplo: `Authorization:
        Bearer sk_live_xxxxx`
    ntfConversionsApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: Clave API en el encabezado x-api-key.

````