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

# Adyen - Acceso a la API de Connect & Raw Card

> Genera la clave de API, cuenta de comerciante y webhook firmado con HMAC que necesitas para conectar Adyen como tu propio procesador con Bring Your Own Processor (BYOP).

<Note>
  Esta guía se aplica cuando conectas **Adyen** como tu propio procesador a través de [Bring Your Own Processor (BYOP)](/features/byop). [Contáctanos](mailto:founders@dodopayments.com) si necesitas ayuda.
</Note>

## Habilitar acceso a datos de tarjeta en bruto

Antes de que Dodo pueda enrutar pagos a través de Adyen, tu cuenta de Adyen necesita tener habilitado el acceso a **datos de tarjeta en bruto**. Adyen controla esto a través del cumplimiento de PCI DSS. Como **Dodo Payments maneja los datos de tarjeta en bruto en tu nombre** y es **cumplidor Nivel 1 de PCI DSS**, proporcionas el **Attestado de Cumplimiento (AOC) de Dodo Payments** a Adyen, por lo que no necesitas tu propia certificación.

<Card title="Dodo Payments PCI DSS Attestation of Compliance (AOC)" icon="file-shield" href="https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf">
  Descarga el AOC actual de Dodo Payments y envíalo al soporte de Adyen para habilitar el acceso a datos de tarjeta en bruto.
</Card>

Contacta al soporte de Adyen para solicitar acceso a tarjeta en bruto para tu cuenta de comerciante, adjuntando el AOC anteriormente mencionado.

## Lo que necesitarás

Para conectar Adyen en **Configuración → BYOP**, reúne tres valores de tu Área de Cliente de Adyen:

| Valor                     | Origen                                          |
| ------------------------- | ----------------------------------------------- |
| **Clave de API**          | Desarrolladores → Credenciales de API           |
| **Cuenta de Comerciante** | Identificador de cuenta de comerciante de Adyen |
| **Clave HMAC**            | Generada cuando configures el webhook           |

<Info>
  Adyen mantiene separadas las credenciales de **prueba** (`ca-test.adyen.com`) y **producción** (`ca-live.adyen.com`). Genera credenciales en el entorno que coincida con el modo que estás configurando en Dodo.
</Info>

## Paso 1: Generar una clave de API

<Steps>
  <Step title="Open API credentials">
    En el Área de Cliente de Adyen, ve a **Desarrolladores → Credenciales de API**. Necesitas el rol de **Gestionar credenciales de API** o **Administrador de comerciantes**.
  </Step>

  <Step title="Select your credential">
    Elige la pestaña **Pagos** y selecciona tu nombre de usuario de credencial (se ve como `ws_123456@Company.YourCompanyAccount`).
  </Step>

  <Step title="Generate the key">
    Ve a **Configuración del servidor → Autenticación**, abre la pestaña **Clave de API** y selecciona **Generar clave de API**.
  </Step>

  <Step title="Copy it immediately">
    Copia y almacena la clave de manera segura; no podrás copiarla de nuevo después de salir de la página. Una clave recién generada está activa inmediatamente y la clave anterior sigue funcionando por 24 horas.
  </Step>
</Steps>

## Paso 2: Encuentra tu cuenta de comerciante

Tu **cuenta de comerciante** es el identificador de cuenta que Adyen utiliza para procesar tus transacciones. Se muestra en el selector de cuentas en la parte superior del Área de Cliente (por ejemplo, `YourCompany_ECOM`). Debes pegar esto en el campo **Cuenta de Comerciante** en Dodo.

## Paso 3: Configura el webhook y la clave HMAC

Dodo genera una URL **Punto Final del Webhook** cuando guardas la conexión con Adyen. Agrégalo como un webhook en Adyen y genera una clave HMAC. Necesitas el rol de **Administrador de comerciantes** o **Integrador técnico de comerciantes**.

<Steps>
  <Step title="Create a webhook">
    En el Área de Cliente, ve a **Desarrolladores → Webhooks** y selecciona **Crear nuevo webhook**. De la lista, selecciona **Agregar** para el tipo **Webhook estándar**.
  </Step>

  <Step title="Configure the webhook">
    * Ingresa una **Descripción**.
    * Activa **Habilitado** para activarlo.
    * En **Configuración del servidor**, pega la URL **Punto Final del Webhook** que Dodo generó en el campo **URL** (debe ser HTTPS y de acceso público).
  </Step>

  <Step title="Generate the HMAC key">
    Bajo **Seguridad**, en la sección **Clave HMAC**, selecciona **Generar** para crear una nueva clave HMAC. Cópiala y almacénala de manera segura; no podrás copiarla de nuevo más tarde. Luego selecciona **Guardar configuración**.
  </Step>

  <Step title="Paste the HMAC key into Dodo">
    De vuelta en **Configuración → BYOP**, pega la clave HMAC en el campo **Secreto de Firma del Webhook** para terminar la conexión.

    <Card title="Set up BYOP" icon="shuffle" href="/features/byop">
      Sigue el flujo completo de configuración de Bring Your Own Processor.
    </Card>
  </Step>
</Steps>

<Tip>
  Después de guardar, usa **Verificar conexión** en Dodo para ejecutar una llamada de prueba contra Adyen y confirmar que tu clave de API, cuenta de comerciante y clave HMAC son válidas antes de ir a producción.
</Tip>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="What is the HMAC key for?">
    Adyen firma cada webhook con una firma HMAC para que el receptor pueda verificar la integridad y origen de la notificación. Dodo utiliza la clave HMAC que proporcionas para validar webhooks desde tu cuenta de Adyen.
  </Accordion>

  <Accordion title="I lost my API key or HMAC key, what now?">
    Ninguno de los dos puede ser recuperado después de su creación. Genera una nueva clave de API en **Desarrolladores → Credenciales de API**, o una nueva clave HMAC en la configuración del webhook, luego actualiza el valor en **Configuración → BYOP**.
  </Accordion>

  <Accordion title="Do test and live use the same credentials?">
    No. Genera credenciales en el entorno correspondiente, prueba (`ca-test.adyen.com`) o producción (`ca-live.adyen.com`), y configúralas en el modo correspondiente en Dodo.
  </Accordion>
</AccordionGroup>

## Referencias

* [Adyen: Credenciales de API](https://docs.adyen.com/development-resources/api-credentials/)
* [Adyen: Configurar y gestionar webhooks](https://docs.adyen.com/development-resources/webhooks/configure-and-manage)