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

# dLocal

> Cobrá con tarjeta, débito y transferencias locales conectando tu cuenta de dLocal Go a tu productora

# dLocal

dLocal es un medio de cobro para productoras de **Argentina, Brasil, Chile, Colombia, Ecuador, Guatemala, México, Perú y Uruguay**. Conectás tu cuenta de **dLocal Go** y tus compradores pueden pagar con **tarjeta de crédito, débito y transferencias locales** (por ejemplo PIX en Brasil) desde la página de tu evento.

El dinero de cada venta entra **directamente a tu cuenta de dLocal Go**. qrTicket no retiene ni maneja tu plata.

<Note>
  dLocal aparece en el menú **solo si tu productora es de uno de esos países**. En El Salvador y Honduras dLocal Go no permite cobrar a compradores locales: ahí usá [Recurrente](/organizations/recurrente).
</Note>

<Note>
  **Importante:** para conectar dLocal necesitás un rol con permiso para administrar la productora (por defecto, el **Administrador**). Mirá [Roles y permisos](/organizations/roles).
</Note>

## Antes de empezar

<Steps>
  <Step title="Tené tu cuenta de dLocal Go">
    Si todavía no tenés, creala en [dlocalgo.com](https://dlocalgo.com). Los requisitos de verificación para empezar a cobrar los define dLocal.
  </Step>

  <Step title="Declará la página de tu productora como sitio web">
    dLocal Go asocia cada cuenta a un sitio web y puede bloquear las claves si se usan en otro. Cuando te lo pida, declará la página pública de tu productora en qrTicket. La vas a ver escrita en la pantalla de conexión.
  </Step>

  <Step title="Configurá tu país en qrTicket">
    La productora tiene que estar creada con el país correcto. Podés cambiarlo en [Configuración](/organizations/settings).
  </Step>
</Steps>

***

## Cómo acceder

<Steps>
  <Step title="Abrí tu productora">
    Dashboard → Tu productora
  </Step>

  <Step title="Entrá a dLocal">
    En la sección **"Cuentas de cobro"** (del menú lateral o del inicio de la productora), hacé clic en **"dLocal"**. En el inicio, la tarjeta te muestra el estado: por ejemplo **"Conectada"**.
  </Step>
</Steps>

En esta pantalla vas a ver el encabezado **"Conectar dLocal"** y el estado de tu cuenta: **Conectado** o **Desconectado**.

***

## Conectar tu cuenta

La conexión se hace pegando las dos claves de API de tu cuenta de dLocal Go: la **API key** y la **Secret key**. Con ellas los cobros salen a tu nombre y el dinero cae en tu cuenta.

<Steps>
  <Step title="Dirigite a la configuración">
    Dashboard → Tu productora → **"dLocal"**
  </Step>

  <Step title="Pegá tus claves">
    Copiá la **API key** y la **Secret key** desde tu panel de dLocal Go y pegalas en los campos con esos nombres. Si no sabés de dónde sacarlas, mirá el instructivo de abajo.
  </Step>

  <Step title="Conectar">
    Hacé clic en **"Conectar dLocal"**. Verificamos las claves contra dLocal y, si son válidas, el estado pasa a **Conectado** y te mostramos el nombre de la cuenta vinculada.
  </Step>
</Steps>

<Accordion title="¿No sabés dónde encontrar tus claves?">
  Las claves están en tu propio panel de dLocal Go:

  <Steps>
    <Step title="Entrá a tu cuenta">
      Ingresá a [dashboard.dlocalgo.com](https://dashboard.dlocalgo.com) con tu usuario.
    </Step>

    <Step title="Abrí la integración por API">
      Andá a **Integraciones → Integración API**.
    </Step>

    <Step title="Copiá las dos claves">
      Copiá la **API key** y la **Secret key**. Tienen que ser de la **misma cuenta**.
    </Step>
  </Steps>

  <Warning>
    Tu Secret key es **privada**: no la compartas ni la publiques. Cualquiera que la tenga puede cobrar en tu nombre. Si creés que se filtró, generá claves nuevas en dLocal Go y volvé a conectarlas acá.
  </Warning>
</Accordion>

### Qué pasa cuando conectás

No tenés que configurar nada más en dLocal: cada pago que se crea desde qrTicket le indica a dLocal adónde avisarnos. Cuando un comprador te paga, emitimos la entrada y se la mandamos por email.

### Claves de prueba

dLocal Go también te da claves de prueba (sandbox), que **no mueven dinero real**. qrTicket no las acepta: si las pegás vas a ver el aviso *"Esas son las claves de prueba (sandbox). Pegá las de tu cuenta real de dLocal Go."*

***

## Cuenta conectada

Una vez conectada, en la sección **dLocal** vas a ver:

* El estado **"Conectado"** y el nombre de la cuenta vinculada.
* El campo **"Apodo de la cuenta"**, editable, para identificar fácilmente qué cuenta tenés vinculada (por ejemplo, "Cuenta de la productora"). Aparece en la columna **"Cuenta"** de tus ventas.
* **"Reemplazar las claves"**, por si generaste claves nuevas en dLocal Go.
* El botón **"Desconectar"**.

<Note>
  Por seguridad **no mostramos las claves guardadas**. Si las perdiste, buscalas o generalas de nuevo en dLocal Go y pegalas en "Reemplazar las claves".
</Note>

### Cambiar de cuenta

Para vincular otra cuenta de dLocal Go, pegá la API key y la Secret key de esa cuenta en **"Reemplazar las claves"** y tocá **"Actualizar"**.

### Desconectar

Al tocar **"Desconectar"** se elimina la conexión y **se apagan las ventas con dLocal en todos tus eventos**, para que ninguna página siga ofreciendo un medio de pago que ya no puede cobrar.

***

## Activar la venta en tus eventos

Conectar dLocal a tu productora habilita el cobro, pero todavía tenés que activarlo en cada evento que quieras vender online.

<Steps>
  <Step title="Tu producto debe tener precio">
    Para vender con dLocal, el tipo de entrada debe tener un precio configurado. Más información en [Tipos de Entrada](/events/products).
  </Step>

  <Step title="Activá la venta en el evento">
    Dashboard → Tu evento → **"Cobros"** → tocá la tarjeta **dLocal** → encendé **"Vender con dLocal"**.
  </Step>

  <Step title="Verificar configuración">
    Si todo está bien, la tarjeta de dLocal muestra **"Activo"**.
  </Step>
</Steps>

<Tip>
  Si todavía no conectaste dLocal, el panel del evento te muestra **"Conectá tu cuenta de dLocal"** con el botón **"Conectar"**, que abre esta pantalla en otra pestaña. Pegás tus claves y volvés a la pestaña del evento.
</Tip>

<Card title="Más sobre Cobros" icon="credit-card" href="/events/sales">
  Mirá cómo configurar todos los medios de cobro de un evento.
</Card>

### ¿Qué pasa cuando está habilitado?

* Los compradores ven el botón **"Comprar entradas"** en tu página del evento
* Eligen **"Tarjeta (dLocal)"** y pagan en el checkout de dLocal, con los medios de su país
* Tras el pago exitoso, reciben las entradas por email
* **Se consumen créditos automáticamente** por cada entrada vendida

### Plazo para pagar

El comprador tiene **60 minutos** para completar el pago. Si no paga en ese plazo, la compra se cancela sola. Por eso el checkout ofrece **tarjeta de crédito, débito y transferencias**, pero no pagos en efectivo (como OXXO, Boleto o Rapipago), que se pagan horas o días después.

***

## Monedas

dLocal cobra en la **moneda de tu productora**, que queda definida por el **País** que elegís al crearla:

| País de la productora | Moneda |
| - | - |
| Argentina | ARS (pesos argentinos) |
| Brasil | BRL (reales) |
| Chile | CLP (pesos chilenos) |
| Colombia | COP (pesos colombianos) |
| Ecuador | USD (dólares) |
| Guatemala | GTQ (quetzales) |
| México | MXN (pesos mexicanos) |
| Perú | PEN (soles) |
| Uruguay | UYU (pesos uruguayos) |

<Note>
  La moneda se define **una sola vez** por la productora y la heredan todos sus eventos y ventas. No se elige por evento ni la elige el comprador. Para cambiarla, tenés que cambiar el país de la productora.
</Note>

### Monto mínimo de cobro

Si el total del carrito queda por debajo del mínimo que aceptan los medios de pago online, el comprador ve un aviso pidiéndole que sume más entradas o elija otro medio de pago.

***

## Cargos de dLocal

En cada evento, en **"Cobros"** → **dLocal**, respondés **"¿Quién paga la comisión?"**:

* **Vos** (recomendado): absorbés el cargo de procesamiento; el comprador paga el precio de la entrada. Te conviene incluirlo en ese precio.
* **El comprador**: se le suma un recargo al pagar y vos recibís el precio de la entrada. En **"Cuánto se suma"** elegís **3,5%** (débito y transferencia), **5%** (tarjeta de crédito), **6,5%** (tarjeta con impuestos) u **"Otro"** para escribir tu porcentaje. Por defecto se elige **6,5%**.

<Note>
  El cargo real de dLocal varía según el país, el medio de pago que elija el comprador y las condiciones de tu cuenta. Elegí un porcentaje que cubra ese cargo. qrTicket **no cobra comisión por venta**: el único cargo adicional es del medio de pago.
</Note>

***

## ¿Cuándo recibo el dinero?

El dinero de cada venta entra **directamente a tu cuenta de dLocal Go**, y de ahí seguís el flujo de retiros que tengas configurado en tu cuenta.

<Warning>
  Los tiempos de liquidación, los retiros a tu banco y las comisiones se manejan directamente en tu cuenta de dLocal Go, no en qrTicket.
</Warning>

## Reembolsos

Podés reembolsar una compra desde el dashboard de qrTicket. El reembolso se hace **por la compra completa** (no por entrada suelta): se devuelve la plata al comprador y, cuando dLocal confirma la devolución, las entradas de esa compra quedan marcadas como reembolsadas.

<Warning>
  Los **créditos** consumidos por esas entradas **no se recuperan**. Hacé los reembolsos **desde qrTicket**: si devolvés un pago desde el panel de dLocal Go, la compra no se marca sola como reembolsada acá. Lo mismo pasa con los contracargos.
</Warning>

***

## Problemas comunes

<AccordionGroup>
  <Accordion title="'No veo dLocal en el menú de mi productora'">
    dLocal solo está disponible para productoras de **Argentina, Brasil, Chile, Colombia, Ecuador, Guatemala, México, Perú y Uruguay**. Revisá el país en [Configuración](/organizations/settings).

    También necesitás un rol con permiso para administrar la productora. Mirá [Roles y permisos](/organizations/roles).
  </Accordion>

  <Accordion title="'dLocal rechazó las claves'">
    **Verificá:**

    * Que la **API key** y la **Secret key** sean de la **misma cuenta**
    * Que no las hayas regenerado en dLocal Go después de copiarlas
    * Que las hayas copiado completas, sin espacios al principio o al final
  </Accordion>

  <Accordion title="'Dice que son claves de prueba'">
    Pegaste las claves del entorno de prueba (sandbox) de dLocal Go, que no mueven dinero real. Copiá las de tu cuenta real desde [dashboard.dlocalgo.com](https://dashboard.dlocalgo.com).
  </Accordion>

  <Accordion title="'No aparece el botón de compra'">
    **Verificá:**

    * Que la productora tenga dLocal conectado
    * Que todos los productos tengan precio (no gratuitos)
    * Que **"Vender con dLocal"** esté activado en **Cobros** del evento (la tarjeta tiene que decir **"Activo"**)
    * Que a la productora le queden créditos disponibles
  </Accordion>

  <Accordion title="'El comprador pagó pero no le llegó la entrada'">
    Revisá primero la carpeta de spam del comprador. La entrada se emite apenas dLocal nos confirma el pago, y lo volvemos a consultar cada media hora por si un aviso no llegó. Si el pago figura como aprobado en dLocal Go y la compra sigue pendiente en qrTicket, escribinos por WhatsApp con el link del evento y el email del comprador.
  </Accordion>
</AccordionGroup>

***

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Cobros" icon="credit-card" href="/events/sales">
    Combiná dLocal con transferencia bancaria y WhatsApp
  </Card>

  <Card title="Tipos de entrada" icon="ticket" href="/events/products">
    Configurá precios y límites de tus entradas
  </Card>
</CardGroup>

***

¿Necesitás ayuda? Contactanos por [WhatsApp](https://wa.me/5491122503348).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.