Un payout es un retiro o transferencia de fondos que realizas desde tu balance disponible en dLocal Go hacia la cuenta bancaria de un tercero. Esta solución te permite enviar fondos mediante flujos tanto B2B (de empresa a empresa) como B2C (de empresa a un individuo), operando actualmente para cuentas de destino en Argentina, Brasil, Ecuador, México, Perú, Paraguay y Uruguay.
¿Cuáles son los estados por los que pasa mi envío de dinero?
Cuando creas una solicitud de transferencia enviando una petición al endpoint de la API, tu envío de dinero iniciará un recorrido automatizado a través de los siguientes estados:
PENDING (Pendiente): Al momento de crear una solicitud de forma exitosa, tu envío iniciará siempre en este estado. Esto significa que los fondos han sido reservados en tu balance y la orden aguarda a ser procesada por la red bancaria.
PROCESSING (Procesando): A medida que el dinero avanza y es transmitido hacia la entidad financiera de destino, el estado cambiará de manera automática para reflejar que los fondos se encuentran en tránsito interbancario.
DELIVERED (Entregado) o COMPLETED (Completado): Se alcanza este estado una vez que el ciclo concluye de forma exitosa y el banco de destino acredita el dinero en la cuenta del beneficiario de manera definitiva.
¿Qué significa que mi pago esté ON_HOLD (En pausa)?
Este estado te indica que la transacción se encuentra retenida momentáneamente en una etapa de revisión preventiva.
Aunque el sistema puede pausar transferencias por diversas validaciones, el motivo más recurrente para experimentar demoras por revisión de cumplimiento (compliance review) es haber enviado un código de propósito (Purpose code) que el banco local considera inválido, no clasificado o que requiere análisis adicional. Recuerda que especificar la razón exacta del pago es un requisito mandatorio para cumplir con las normativas internacionales y procesar cualquier payout.
Mi pago dice REJECTED (Rechazado) o FAILED (Fallido), ¿qué hago?
Si visualizas que tu transferencia cambió al estado REJECTED, FAILED o CANCELLED, significa que el envío de dinero no pudo concretarse y la solicitud fue cancelada definitivamente por el sistema o la entidad bancaria.
Los errores y rechazos más frecuentes bajo estos estados ocurren debido a:
El incumplimiento de requisitos regulatorios u operativos específicos impuestos por el banco de destino en el país seleccionado.
El envío de un código de propósito (Purpose code) erróneo o que no está soportado por las normativas de la entidad local.
¿Cómo proceder? Ante esta situación, debes verificar minuciosamente que todos los datos de la cuenta destino y del beneficiario (número de cuenta, tipo de cuenta, código bancario y documento de identidad) coincidan de forma exacta. Posteriormente, asegúrate de utilizar un código de propósito válido y vuelve a generar la solicitud de payout desde el principio.
Buenas prácticas para tus transferencias (Integración API)
Para asegurar que tus fondos transiten sin fricciones y evitar demoras regulatorias o rechazos preventivos, adopta las siguientes recomendaciones operativas en tu integración:
Formato técnico obligatorio: Utiliza estrictamente la nomenclatura
snake_casepara la totalidad de los campos enviados en el cuerpo de tus peticiones JSON (por ejemplo:transfer_amountocurrency_to_pay).Uso correcto de la Razón Social: El campo
business_namees condicional; debes incluirlo de manera obligatoria únicamente si estás operando un flujo corporativo B2B y omitirlo por completo si realizas un flujo B2C.Validación de propósito: Asegúrate de transmitir siempre un parámetro
purposeválido y alineado con los códigos oficiales permitidos (comoPAYROLLpara nóminas,SUPPLIERpara proveedores oREWARDSpara incentivos). Esto agiliza el screening transfronterizo de las instituciones financieras.