Saltar al contenido principal
En esta página

Conecta su cuenta Worldpay en el administrador de DEUNA, luego configura Worldpay para enviar actualizaciones de transacciones a DEUNA. Ambos pasos son importantes: guardar una conexión agrega sus credenciales, mientras que las notificaciones permiten a DEUNA conciliar los resultados del pago después del procesamiento.

01
preparar
Confirma el acceso a la cuenta, las credenciales y las operaciones admitidas.
02
Conectar en DEUNA
Agregue Worldpay y elija cómo se procesan los pagos.
03
Configurar notificaciones
Habilite los eventos Worldpay que mantienen actualizado DEUNA.
04
Verificar el flujo
Prueba los resultados del pago antes de utilizar las credenciales de producción.

Antes de empezar#

Esta guía está dirigida a quienes administran las conexiones de pago de su comercio o tienda. Necesitas acceso a Conexiones en DEUNA Admin y a Worldpay Merchant Administration Interface (MAI). Si no tienes acceso a alguna de ellas, solicítalo al administrador de tu cuenta.

Confirma tu cuenta y tus credenciales

Ten lo siguiente listo para el entorno que está configurando:

  • Una cuenta Worldpay habilitada y su ID de comerciante.
  • Las credenciales de conexión XML de Worldpay, incluidos los valores que DEUNA identifica como Clave privada y Clave pública.
  • Las credenciales de acceso a Worldpay MAI para configurar las notificaciones.
  • Acceso al comercio o tienda donde se creará la conexión DEUNA.

Solicita estas credenciales a su representante Worldpay. Confirma que las credenciales admitan la operación y el entorno seleccionados; Las credenciales de inicio de sesión MAI y las credenciales de conexión XML tienen diferentes propósitos. Ingresa las credenciales de conexión solo en DEUNA Admin y manténgalas fuera del código de pago, capturas de pantalla y mensajes de soporte.

Confirmar disponibilidad de pago

Compruebe el catálogo de capacidades de Worldpay para su mercado, moneda, marcas de tarjetas y operaciones requeridas. La disponibilidad depende de la cuenta y la conexión; Las descripciones de las funciones a continuación no implican que todas las funciones estén habilitadas para todos los comerciantes.

Confirma con Worldpay los requisitos de adquirencia local y de entidad legal para cada país. Si usarás 3-D Secure, cuotas, billeteras o varias operaciones parciales, acuerda la configuración necesaria con DEUNA y Worldpay antes de hacer pruebas.

Monedas aceptadas

ARS · BRL · EUR · GBP · JPY · MXN · USD

La disponibilidad de monedas depende de la cuenta de comercio de Worldpay y de la conexión. Confirma qué monedas están habilitadas para tu cuenta antes de hacer pruebas.

1. Conecta Worldpay en DEUNA#

Acceda a Administrador DEUNA, selecciona el comercio o la tienda correspondiente y ve a Conexiones. En Descubrir, busca Worldpay y selecciona Conectar.

La vista previa muestra cómo encontrar Worldpay, configurar las credenciales y revisar la conexión guardada. Los controles son ilustrativos; configura tu cuenta real en DEUNA Admin.

DEUNA Admin · Vista de configuración
ConexionesSandbox
DescubrirActivas
Buscar conexiones
Worldpay
Pasarela de pagoWorldpay
Configuración ilustrativa. No se envían credenciales.

Ingresa la configuración de conexión

  1. Elige un nombre de conexión reconocible para que su equipo pueda distinguirlo de otras cuentas o entornos.
  2. Selecciona la moneda cuando se le solicite e ingrese las credenciales Worldpay emitidas para esa conexión.
  3. Elige Compra para autorizar y solicitar captura en un flujo de pago, o Autorización si enviará una solicitud de captura por separado más adelante.
  4. Configura 3-D Secure solo después de confirmar el flujo de autenticación admitido con DEUNA. Ver Manejo seguro en 3-D antes de implementar el pago.
  5. Selecciona Conectar, luego verifica que Worldpay aparezca en Conexiones activas.
Campo DEUNAValor a ingresar
Merchant IDEl ID de comerciante Worldpay emitido para la conexión.
Clave PrivadaLa clave privada XML Worldpay.
Clave PúblicaLa contraseña pública XML Worldpay.

Para pagos de aerolíneas, complete también los campos del emisor requeridos por su configuración: Nombre del emisor, Dirección del emisor1, Código postal del emisor, Ciudad del emisor y Código de país del emisor. Estos identifican a la aerolínea que emite el billete; utilice un código de país ISO de dos letras para su país. No reemplazan los datos de pasajeros, boletos e itinerarios enviados con un pago.

Una conexión en Conexiones activas confirma que se guardó. Continúa con las notificaciones Worldpay y una prueba de pago antes de considerar la integración como lista.

2. Configurar notificaciones Worldpay#

Worldpay envía notificaciones a DEUNA para actualizar el estado del pago tras procesar una autorización, captura, cancelación o reembolso. Tu backend recibe las actualizaciones mediante una configuración independiente de webhooks de DEUNA. Configura ambas rutas cuando la integración necesite actualizaciones asíncronas.

Ver Notificaciones de estado de pago DEUNA para la configuración del lado comercial.

Establecer la dirección de notificación

En Worldpay MAI, abra Integration → Merchant Channel. en el http fila, conjunto Active funcione Yes, establecer Method funcione POSTe ingrese la dirección de notificación para el entorno coincidente.

Medio ambienteDirección de notificación Worldpay
Caja de arenahttps://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay
Producciónhttps://api.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay

Confirma la dirección con DEUNA para su conexión antes de guardarla. Worldpay llama a esta dirección; su aplicación no lo llama para crear un pago o recuperar su estado.

Worldpay MAI: use the http row to configure notification delivery. Labels in Worldpay's own interface may differ from your documentation language.

Habilitar eventos de transacción

En Merchant Channel Events (Production), selecciona los siguientes eventos en el http fila. Mantén los identificadores de eventos exactamente como se muestran.

Etapa de pagoEventos para habilitar
Autorización y erroresAUTHORIZED, REFUSED, ERROR
CapturaCAPTURED, CAPTURE_FAILED
ReembolsoSENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED
Cancelación y reversiónSHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED
Worldpay MAI: enable the listed events in the http row, then save the configuration.

3. Prueba el flujo de pago completo#

Usa credenciales de zona de pruebas y el flujo de pago admitido por su conexión. Una prueba de conexión exitosa debe mostrar tanto la operación de pago solicitada como su estado resultante.

Las solicitudes de captura, reembolso y anulación pueden quedar pendientes mientras Worldpay las procesa. La aceptación de una solicitud, el retorno del navegador o un tiempo de espera agotado no confirman el resultado final. Consulta el estado más reciente de la orden y los webhooks de DEUNA configurados para conciliar el pago original antes de reintentar o dar la operación por terminada.

Ver Flujo de trabajo y estados de pago para el ciclo de vida del pago y Webhooks DEUNA para notificaciones de backend.

Si el resultado esperado no llega

  • Si no se puede guardar la conexión, verifica la cuenta seleccionada, el entorno, la operación y las credenciales XML con Worldpay.
  • Si queda algún pago pendiente, verifica la dirección de notificación Worldpay, POST método, y seleccionado http eventos antes de volver a intentar la operación original.
  • Si DEUNA tiene el resultado pero su backend no, verifica su Configuración de entrega de webhook DEUNA.

Al escalar a DEUNA, incluye el entorno, la referencia del pedido, el intento de operación y el estado observado. No incluye credenciales ni datos completos de la tarjeta.

Pasar a producción

Repite la configuración de conexión y notificación con las credenciales de producción y la dirección de notificación de producción. Confirma las operaciones habilitadas y los requisitos de certificación con DEUNA y Worldpay, luego verifica el flujo de pago de producción antes de aceptar el tráfico de clientes.

Operaciones soportadas#

Usa esta referencia para elegir el flujo de pago a configurar y probar. Confirma cada característica con la catálogo de capacidades de Worldpay y la configuración de su cuenta.

Función¿Qué hace?
AutorizaciónReserva el importe solicitado en la cuenta del titular sin capturar los fondos. Se requiere una captura posterior para cobrar el pago.
CapturaCobra los fondos de un pago previamente autorizado. Una captura total cobra el importe autorizado disponible.
CompraAutoriza y solicita la captura en un único flujo de pago, sin que el comercio envíe una solicitud de captura separada.
Captura parcialCaptura una parte del importe previamente autorizado. Las capturas múltiples requieren una habilitación adicional.
Múltiples capturas parcialesPermite varias capturas sobre una misma autorización, sin superar el saldo autorizado disponible. El modo de operación y la vigencia de la autorización determinan cómo y cuándo pueden solicitarse.
AnulaciónCancela una autorización no capturada y solicita liberar el importe que sigue reservado. No devuelve fondos que ya se hayan capturado.
ReembolsosDevuelve fondos capturados al titular de la tarjeta. Un reembolso total devuelve el saldo reembolsable restante.
Reembolsos parcialesDevuelve una parte del importe capturado al titular de la tarjeta.
Múltiples reembolsos parcialesPermite varios reembolsos sobre el mismo pago capturado cuando está habilitado. El importe reembolsado acumulado no puede superar el importe capturado confirmado.
Cuotas del emisorPermite que titulares elegibles dividan una compra en cuotas según las condiciones admitidas por el emisor, el adquirente y la conexión del comercio.
Carteras digitalesAdmite pagos con Apple Pay y Google Pay cuando la billetera está disponible y habilitada para la conexión Worldpay.
MPI de 3-D SecureDEUNA gestiona la autenticación 3-D Secure, incluidas las comprobaciones del navegador y un desafío del emisor cuando se requiere. La autenticación también puede finalizar sin un desafío visible.
Datos de la aerolíneaTransmite información de la transacción aérea admitida por la conexión, incluidos datos de pasajeros, boletos e itinerarios. Envíe los datos de aerolínea requeridos para su flujo de pago.

Capturas y reembolsos múltiples

La compatibilidad con capturas y reembolsos parciales no habilita automáticamente las operaciones múltiples. Confirme el modo de operación y los límites por pedido con su Technical Account Manager (TAM) de DEUNA y con Worldpay.

En el modo online, cada captura se envía a Worldpay por separado y no se aplica un plazo de corte de captura de DEUNA. Siguen vigentes la validez de la autorización y los límites de captura de Worldpay. El plazo de captura configurado en DEUNA se aplica al modo con acumulación (offline), en el que DEUNA envía el importe acumulado al cerrar la secuencia. Consulte Múltiples capturas parciales para conocer las reglas de cada modo.

Los reembolsos múltiples deben mantenerse dentro del saldo reembolsable confirmado. Si la conexión usa acumulación gestionada por DEUNA, una solicitud parcial registra la intención hasta que se envía el reembolso acumulado; no significa que el cliente haya recibido los fondos. Consulte Múltiples reembolsos parciales para conocer el flujo con acumulación.

Gestiona la autenticación 3-D Secure

Cuando la autenticación requiere una acción en el navegador, DEUNA devuelve la experiencia alojada mediante la siguiente acción del pago. Su integración la presenta con el widget, iframe o redirección compatible. Las comprobaciones del navegador pueden finalizar sin desafío del emisor; el titular solo ve un desafío cuando es necesario.

Una autenticación exitosa no garantiza que el pago esté aprobado o capturado. Confirme el estado final después de que DEUNA complete la autorización o el procesamiento pendiente. Siga el Flujo de compra de 3DS para gestionar la siguiente acción y la recuperación.

Carteras y cuotas

Completa el separado Apple Pay o Google Pay configuración antes de ofrecer una billetera al momento de pagar. La disponibilidad de la billetera depende del mercado y la conexión.

Para cuotas del emisor, ofrezca solo términos elegibles para la tarjeta, el adquirente y la conexión. Ver Cuotas para configurar campañas y enviar la opción seleccionada por el cliente.

Requisitos regionales y de aerolíneas#

Pagos de aerolíneas

Suministra los datos de la aerolínea que requiere tu flujo en la solicitud de autorización o captura. para un airline_order, los datos requeridos de la aerolínea deben estar presentes en al menos una de esas solicitudes. Confirma la información esperada de pasajeros, boletos e itinerario para su conexión antes de realizar la prueba.

Límites de captura y reembolso

Captura antes de que caduque la autorización. Confirma la ventana de captura permitida con Worldpay y DEUNA; un límite de procesamiento por lotes DEUNA no extiende la autorización del emisor. Los reembolsos no pueden exceder el monto capturado confirmado. Sigue el reglas del modo de operación antes de enviar más de una operación parcial.

Transacciones locales en Argentina

Para transacciones adquiridas localmente por Worldpay en Argentina, incluye el código postal, provincia y país del comprador en la solicitud de autorización:

  • billing_address.zipcode
  • billing_address.state_name
  • billing_address.country_code

Worldpay utiliza esta información para la retención de impuestos provinciales. Si no existe, la retención se basa en la ubicación del comerciante. Envíe el código de provincia ISO o el código COMARB en billing_address.state_name, no ambos.

códigos de provincia argentina
Código de provincia COMARBCódigo de provincia ISONombre de la provincia
901AR-CCABA
909AR-PFormosa
919AR-Dsanluis
908AR-EEntre Ríos
911AR-LLa Pampa
917AR-ASalta
906AR-HChaco
907AR-UChubut
910AR-YJujuy
920AR-Zsanta cruz
903AR-KCatamarca
904AR-XCórdoba
912AR-FRioja
922AR-Gsantiago del estero
918AR-Jsan juan
913AR-MMendoza
914AR-NMisiones
915AR-QNeuquén
916AR-RRío Negro
923AR-VTierra del Fuego
902AR-Bbuenos aires
921AR-SSanta Fé
924AR-TTucumán
905AR-WCorrientes

Próximos pasos#