Ultima actualización 19/11/2015

5. Mantenimiento directo

Una solicitud de mantenimiento directa de su aplicación le permite:

  • Realizar una captura de datos (pago) de un pedido autorizado de forma automática (en lugar de hacerlo manualmente en el área de administración);
  • Cancelar una autorización sobre un pedido;
  • Renovar una autorización de un pedido;
  • Reembolsar un pedido pagado.
Las capturas de datos, las cancelaciones de autorización y las renovaciones de autorización son específicamente para comerciantes que hayan configurado su cuenta o sus solicitudes para realizar la autorización y la captura de datos en dos fases.

5.1 Solicitud de mantenimiento

5.1.1 URL de solicitud

  • La URL de solicitud del entorno de PRUEBA es https://ogone.test.v-psp.com/ncol/test/maintenancedirect.asp.
  • La URL de solicitud del entorno de PRODUCCIÓN es https://secure.ogone.com/ncol/prod/maintenancedirect.asp.

Cambiar "test" a "prod"

Sustituya “test” por “prod” en la URL de solicitud cuando cambie a la cuenta de producción. Si olvida cambiar la URL de solicitud una vez que empiece a trabajar con pedidos reales, las transacciones de mantenimiento se enviarán al entorno de prueba y no a las entidades adquirientes/los bancos.

5.1.2 Parámetros de solicitud

La siguiente tabla contiene los parámetros de solicitud obligatorios para realizar una operación de mantenimiento:

Campo Descripción
AMOUNT
Importe del pedido multiplicado por 100.

Sólo es necesario cuando el importe del mantenimiento difiere del importe de la autorización original. No obstante, recomendamos su uso en todos los casos.

Nuestro sistema comprobará que el importe de la transacción de mantenimiento no sea más alto que el importe de autorización/pago.
OPERATION

Valores posibles:

  • REN: renovación de autorización, si la autorización original ya no es válida.
  • DEL: eliminar autorización, dejando la transacción abierta para más operaciones de mantenimiento potenciales.
  • DES: eliminar autorización, cerrando la transacción después de esta operación.
  • SAL: captura de datos parcial (pago), dejando la transacción abierta para otra captura de datos potencial.
  • SAS: captura (final) de datos parcial o completa (pago), cerrando la transacción (para capturas de datos adicionales) después de esta captura de datos.
  • RFD: reembolso parcial (de un pedido pagado), dejando la transacción abierta para otro reembolso potencial.
  • RFS: reembolso (final) parcial o completo (para un pedido pagado), cerrando la transacción después de este reembolso.

Tenga en cuenta que, con DEL y DES, no todas las entidades adquirentes admiten la eliminación de una autorización. Si la entidad adquirente no admite DEL/DES, simularemos en cualquier caso la eliminación de la autorización en el área de administración.

ORDERID Puede enviar el PAYID o el orderID para identificar el pedido original. Recomendamos el uso del PAYID.
PAYID
PSPID El PSPID de su cuenta.
PSWD Contraseña del usuario API
SHASIGN Firma (cadena con hash) para autenticar los datos (consulte Firma SHA-IN).
USERID Su usuario API

5.1.3 Página de prueba

Puede probar las solicitudes de mantenimiento directas aquí: https://ogone.test.v-psp.com/ncol/test/testdm.asp

5.2 Respuesta de mantenimiento

Nuestro servidor devuelve una respuesta XML a la solicitud:

Ejemplo de una respuesta XML a una solicitud de mantenimiento directa
<?xml version=”1.0”?>
<ncresponse orderID=”99999” PAYID=”1111111” PAYIDSUB=”3” NCSTATUS=”0” NCERROR=”” NCERRORPLUS=”” ACCEPTANCE=”12345” STATUS="91" amount="125" currency="EUR"/> 

La siguiente tabla contiene una lista de los atributos de etiqueta ncresponse:

Campo
Descripción
ACCEPTANCE Código de aceptación devuelto por la entidad adquiriente
AMOUNT Importe del pedido (sin multiplicar por 100)
CURRENCY Divisa del pedido
NCERROR Código de error
NCERRORPLUS Explicación del código de error
NCSTATUS Primer dígito de NCERROR
ORDERID
Su referencia de pedido
PAYID Referencia de pago en nuestro sistema
PAYIDSUB El ID de nivel de historial de la operación de mantenimiento del PAYID
STATUS Estado de la transacción (Posibles estados)

Los atributos de etiqueta ncresponse estándar son los mismos que los de la respuesta XML a un nuevo pedido, salvo el atributo extra PAYIDSUB.

5.3 Solicitud duplicada

Si se solicita mantenimiento dos veces para el mismo pedido, el segundo se rechazará, en teoría, con un error “50001127” (este pedido no está autorizado), porque la transacción correcta inicial habrá cambiado el estado del pedido.

Este sitio web utiliza cookies para poder darle la mejor experiencia de usuario. Si usted no desea aceptar estas cookies, permitimos que cambie la configuración de cookies. Haga clic en "Aceptar" para permitir todas las cookies de este sitio web.

Ajustes de cookies

Introducción

Funcional

Cookies funcionales son necesarios para el sitio web funcione correctamente. Estas cookies no se pueden desactivar.

Optimizado

Cookies de optimización nos permiten analizar el uso del sitio para que podamos medir y mejorar nuestro sitio web.
Este es el nivel predeterminado.

Personalizado

Cookies de personalización se utilizan para los medios sociales y la personalización antelación. Ellos nos permiten mostrarle información relacionada con su empresa. 


Ejemplo de funcionalidad permitida

  • Tienda preferencia país
  • Tienda preferencia de idioma

Ejemplo de funcionalidad no permitido

  • Guardar los datos personales
  • Seguimiento anónimo a través de Google Analytics
  • Seguimiento para fines de marketing

Ejemplo de funcionalidad permitida

  • Tienda preferencia país
  • Tienda preferencia de idioma
  • Seguimiento anónimo a través de Google Analytics

Ejemplo de funcionalidad no permitido

  • Guardar los datos personale
  • Seguimiento para fines de marketing

Ejemplo de funcionalidad permitida

  • Tienda preferencia país
  • Tienda preferencia de idioma
  • Seguimiento anónimo a través de Google Analytics
  • Servir contenido relevante a sus intereses
  • Servir anuncios relevantes para sus intereses
  • Seguimiento para fines de marketing

Ejemplo de funcionalidad no permitido

  • Guardar los datos personale