Worldpay
Conecta Worldpay a DEUNA, configura notificaciones de pago y verifica el flujo de pago completo antes de activarlo.
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.
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.
Ingresa la configuración de conexión
- Elige un nombre de conexión reconocible para que su equipo pueda distinguirlo de otras cuentas o entornos.
- Selecciona la moneda cuando se le solicite e ingrese las credenciales Worldpay emitidas para esa conexión.
- 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.
- 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.
- Selecciona Conectar, luego verifica que Worldpay aparezca en Conexiones activas.
| Campo DEUNA | Valor a ingresar |
|---|---|
| Merchant ID | El ID de comerciante Worldpay emitido para la conexión. |
| Clave Privada | La clave privada XML Worldpay. |
| Clave Pública | La 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 ambiente | Dirección de notificación Worldpay |
|---|---|
| Caja de arena | https://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
| Producción | https://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.
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 pago | Eventos para habilitar |
|---|---|
| Autorización y errores | AUTHORIZED, REFUSED, ERROR |
| Captura | CAPTURED, CAPTURE_FAILED |
| Reembolso | SENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED |
| Cancelación y reversión | SHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED |
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,
POSTmétodo, y seleccionadohttpeventos 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ón | Reserva el importe solicitado en la cuenta del titular sin capturar los fondos. Se requiere una captura posterior para cobrar el pago. |
| Captura | Cobra los fondos de un pago previamente autorizado. Una captura total cobra el importe autorizado disponible. |
| Compra | Autoriza y solicita la captura en un único flujo de pago, sin que el comercio envíe una solicitud de captura separada. |
| Captura parcial | Captura una parte del importe previamente autorizado. Las capturas múltiples requieren una habilitación adicional. |
| Múltiples capturas parciales | Permite 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ón | Cancela una autorización no capturada y solicita liberar el importe que sigue reservado. No devuelve fondos que ya se hayan capturado. |
| Reembolsos | Devuelve fondos capturados al titular de la tarjeta. Un reembolso total devuelve el saldo reembolsable restante. |
| Reembolsos parciales | Devuelve una parte del importe capturado al titular de la tarjeta. |
| Múltiples reembolsos parciales | Permite varios reembolsos sobre el mismo pago capturado cuando está habilitado. El importe reembolsado acumulado no puede superar el importe capturado confirmado. |
| Cuotas del emisor | Permite 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 digitales | Admite pagos con Apple Pay y Google Pay cuando la billetera está disponible y habilitada para la conexión Worldpay. |
| MPI de 3-D Secure | DEUNA 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ínea | Transmite 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.zipcodebilling_address.state_namebilling_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 COMARB | Código de provincia ISO | Nombre de la provincia |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formosa |
| 919 | AR-D | sanluis |
| 908 | AR-E | Entre Ríos |
| 911 | AR-L | La Pampa |
| 917 | AR-A | Salta |
| 906 | AR-H | Chaco |
| 907 | AR-U | Chubut |
| 910 | AR-Y | Jujuy |
| 920 | AR-Z | santa cruz |
| 903 | AR-K | Catamarca |
| 904 | AR-X | Córdoba |
| 912 | AR-F | Rioja |
| 922 | AR-G | santiago del estero |
| 918 | AR-J | san juan |
| 913 | AR-M | Mendoza |
| 914 | AR-N | Misiones |
| 915 | AR-Q | Neuquén |
| 916 | AR-R | Río Negro |
| 923 | AR-V | Tierra del Fuego |
| 902 | AR-B | buenos aires |
| 921 | AR-S | Santa Fé |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
Próximos pasos#
- Estrategias de pago: configura cuándo se utiliza la cuenta conectada.
- Flujo de compra de 3DS: maneja las acciones del navegador, los resultados de la autenticación y la recuperación.
- Notificaciones de estado de pago: mantenga su backend alineado con DEUNA.