Integración de paysafecard

1. ¿Qué es el Centro de Servicio de paysafecard (MSC)?

   El MSC es una herramienta que le guía paso a paso durante la integración de paysafecard en sus compras online. Una vez que usted está activo puede verificar el estado de sus transacciones allí.

   Al enviar el formulario online, usted será registrado en el Centro de Servicio.

   Durante la integración de paysafecard usted puede utilizar el MSC para:

   • Seleccionar cómo desea integrar paysafecard
   • Cargar los documentos requeridos
   • Firmar el contrato de socio
   • Completar la integración técnica de paysafecard
   • Contactar nuestro soporte

   Una vez que se haya completado la integración, el MSC permanecerá disponible para que usted pueda:

   • Gestionar direcciones IP
   • Descargar informes
   • Verificar el estado de sus transacciones
   • Contactar nuestro soporte/información de contacto en caso de emergencias

   Si usted es un Portal de Pago, solamente podrá utilizar el Centro de Servicio para la integración técnica de paysafecard.

2. ¿Qué tipos de integración de paysafecard como método de pago existen?

   Puede integrar paysafecard directamente o indirectamente usando un plugin, un portal de pago o un servicio de recaudación/completo de PSP (proveedor de servicios de pago).

   Integración técnica directa

   • Realiza un contrato con las pruebas de integración de paysafecard
   • por el MSC
   • Un código de ejemplo está disponible online desde el área de descarga
   • Soporte directo de paysafecard
   • Notificaciones directamente de paysafecard

    

   Integración técnica indirecta

   • PSP –Portal de pago
     • Ingresa directamente a un contrato con la integración técnica con paysafecard
     • completada por un portal de pago verificado por paysafecard
     • No tiene que realizar ningún trabajo técnico.
     • Pruebas de integración simplificadas - Soporte directo de paysafecard
     • Notificaciones directas de paysafecard
     • Puede encontrar una lista de portales de pago aquí
   • PSP – Servicio de recaudación/completo de PSP
     • Contrato no con paysafecard, pero con el servicio de recaudación/completo de PSP
     • Transacciones y facturación también completadas por el servicio de recaudación/completo de PSP
     • No tiene que realizar ningún trabajo técnico
     • Puede encontrar aquí una lista de servicio de recaudación/completo de PSP
   • Sistemas de tienda - plugins de paysafecard verificados
     • Puede entrar directamente en contrato con paysafecard
     • Necesita realizar menos trabajo técnico (solamente ajustar el sistema de tienda)
     • Pruebas de integración simplificadas
     • Soporte del operador del sistema de tienda y paysafecard
     • Notificaciones directamente de paysafecard
3. ¿Cuál es el procedimiento para el proceso de integración técnica de paysafecard?

   Durante la integración técnica de paysafecard como método de pago nuestro MSC le guiará por los siguientes pasos:

   • Seleccione su tipo de integración
     Seleccione si va a integrar paysafecard directa o indirectamente a través de un complemento o un portal de pago.
   • Detalles de acceso a claves de API /MRT para el sistema de prueba
     paysafecard le proporciona las claves API de REST para probar nuestra API de REST y la Herramienta de Información del Comerciante (MRT, solo disponible para el sistema de prueba para comprobar el estado de sus transacciones). Si está integrando con un intermediario o con un portal de pago, este paso puede obviarse.
   • Prueba de integración
     Nuestro MSC suministra una serie de casos de prueba. Estos deben completarse en el orden específico en tiempo real y verificados con nuestro sistema. Si se está integrando con un complemento o con un portal de pago, este paso puede obviarse. Si también implementa uno de nuestros servicios, "Pago" o "Reembolso" una vez que la prueba de integración se haya intermediario satisfactoriamente, nuestro personal prueba esta función.
   • Creación de una whitelist de direcciones IP para el sistema de producción
     Después de completar satisfactoriamente la prueba de integración, solicitamos sus direcciones de IP para el sistema de producción, que debe estar autorizado en nuestro sistema interno.
   • Clave de API para el sistema de producción
     Una vez que se haya completado la lista blanca de direcciones IP, paysafecard le dará información de acceso para el sistema de producción paysafecard. A continuación le solicitamos que integre paysafecard en su sistema de producción introduciendo la información de acceso de REST en
   • su sistema.
     Una vez haya completado este paso, nuestro personal llevará a cabo la transacción de prueba final y verificará que los logotipos de paysafecard y el texto de copia estén actualizados y cumplan con nuestros requisitos de calidad.
   • Estado activo
     Una vez que nuestro personal finalice satisfactoriamente la prueba de aceptación, paysafecard estará autorizada para su utilización como método de pago para sus compras en línea y podrá empezar a procesar pagos con paysafecard.
4. ¿Qué tecnología utiliza paysafecard?

   La aplicación de pago paysafecard está basada en una REST API. REST, Transferencia de Estado Representacional, es un estilo arquitectónico de la WEB. REST utiliza los métodos HTTP convencionales (GET, POST, PUT, DELETE, etc.).

5. ¿Cuáles son los estados que puede tener una transacción paysafecard?

   Las transacciones paysafecard pueden tener 7 estados diferentes

   • INICIADO:
     El estado inicial de una transacción una vez que se ha creado.
   • REDIRECCIONADO:
     El cliente ha sido exitosamente redireccionado a la ventana de pago de paysafecard para autorizar el pago
   • AUTORIZADO:
     El cliente introdujo exitosamente un PIN en la ventana de pago e hizo clic en pagar.
   • ÉXITO:
     La transacción se ha completado con éxito.
   • CANCELADO_COMERCIANTE:
     Usted, como socio, ha cancelado el pago.
   • CANCELADO_CLIENTE:
     El cliente ha activamente cancelado el pago en la ventana de pago.
   • EXPIRADO:
     El cliente no autorizó la transacción dentro del período de tiempo necesario o usted, como socio, no completó el proceso de pago dentro del período de tiempo necesario.
6. ¿Cuáles son los códigos de error más frecuentes?

   Los códigos de error más frecuentes son:

   • 2001 | La transacción ya existe
     Asegúrese que correlationId es un valor único por transacción.
   • 3014 | Criterios de información no disponibles
     Asegúrese de que esté usando un subId previamente acordado con paysafecard.
   • 3034 | Criterios de información inactivos
     Asegúrese de que esté utilizando un subId previamente acordado con paysafecard.
   • 3001 | MID está inactivo 
     Si el proceso de integración no ha finalizado todavía, esto es completamente normal dado que su cuenta permanece inactiva hasta que las últimas pruebas de integración se superen con éxito. Si su cuenta está activa, contacte con nuestro servicio de asistencia técnica.
   • 2029 | El importe debe ser superior a 0 
     Asegúrese de que el importe de la transacción sea superior a 0.
   • 4003 | El importe supera el importe máximo permitido 
     Asegúrese de que el importe de la transacción no supere el máximo permitido (1000 EUR o equivalente en otra moneda).
   • 3002 , 10014 | Divisa no válida 
     La divisa que está usando no ha sido activada para su cuenta. Póngase en contacto con su gerente de cuenta.
   • 2017 | Transacción en un estado incorrecto para esta acción 
     Verifique el estado de la transacción con la información para recuperar el pago y realice una acción conforme a su resultado (vea el flujo de trabajo del pago).
   • 3007 | Intento de débito después del vencimiento del plazo de tiempo 
     La transacción no se cerró dentro del plazo de tiempo de disposición (entre 1 y 10 minutos, definido en nuestras Condiciones) por lo que venció. El importe se devuelve al cupón o cuenta de paysafecard del cliente.
   • 2002 | La transacción no existe 
     Asegúrese que el paymentId sea el correcto.
   • 10008 | La autenticación falló 
     Asegúrese de estar utilizando la clave y el extremo de API correctos. Puede generar nuevas claves de API en el MSC.
   • 10007 | Error técnico general 
     Póngase en contacto con paysafecard inmediatamente por medio de integration@paysafecard.com si la cuenta no está activa. Para cuentas activas, debe ponerse en contacto con techsupport@paysafecard.com.
   • Error técnico en el panel de pago
     Asegúrese de que el vínculo de redireccionamiento al panel de pago que está utilizando sea correcto y que la transacción no haya vencido.
   • 3162 | no se encuentra mi cuenta de my paysafecard con las credenciales suministradas 
     Asegúrese de que la dirección de correo introducida en la solicitud de pago corresponda con la dirección de correo electrónico registrada en su cuenta de my paysafecard
   • 3195 | La información de la cuenta del cliente no coincide
     Asegúrese de que el nombre, el apellido y la fecha de nacimiento introducidos en la solicitud de pago coincidan con los que aparecen en su cuenta demy paysafecard.
7. ¿Qué significa "Payment Landing Page" (Página de Inicio de Pago)?

   Esto se refiere a la ventana de pago de paysafecard. Después de comenzar una transacción, debe redirigir al cliente a la ventana de pago para que pueda introducir un PIN de paysafecard o su información de usuario para autorizar la transacción.

8. ¿Cuánto tiempo tiene el cliente para introducir un PIN o su información de usuario de "my paysafecard" en la ventana de pago?

   El cliente tiene 30 minutos para autorizar el pago.

   Una vez que se ha creado una transacción de pago ("Initiate Payment" (Iniciar Pago)), el cliente tiene 30 minutos para introducir un PIN en la ventana de pago o acceder con su código de my paysafecard. Una vez que han transcurrido 30 minutos sin un PIN o registro de my paysafecard, el estado de la transacción se actualizará de “REDIRECTED” (REDIRIGIDA) a “EXPIRED” (VENCIDA). Las transacciones con el estado “EXPIRED” (VENCIDA) no son exitosas y el cliente debe crear una nueva transacción de pago.

9. ¿Qué sucede si la solicitud de “Capture Payment” (Capturar Pago) se realiza más de una vez durante una única transacción?

   Si la primera solicitud de “Capture Payment” se realiza correctamente, las siguientes fallarán con código de error 2017.

   Una vez que la solicitud de "Capture Payment" se haya completado, el estado de la transacción se actualiza a "ÉXITO", lo que significa que se ha completado correctamente. Si se realiza otra solicitud de “Capture Payment” para la misma transacción, se devuelve la respuesta [http400 and Error Code = 2017]. Con el fin de evitar esto, el estado de la transacción siempre debe verificarse con "Retrieve Payment Details “ "Recuperar Datos de la Transacción" y solo se debe realizar "Capture Payment” si el estado es “AUTHORIZED” (AUTORIZADO).

10. ¿Cuándo se debita el monto de la transacción del PIN o cuenta del cliente?

    Sólo si ""Capture Payment"" es exitoso, el monto de la transacción se debita del cliente.

    Si “Capture Payment” no se llama o no es exitoso, el monto de la transacción será devuelto a la cuenta o cupón paysafecard del cliente transcurrido el tiempo de disposición (disposition time window).

11. ¿Qué significa el término "Disposition Time Window"?

    Es el momento que tiene que llamar "Capture Payment" una vez que el cliente haya autorizado la transacción.

    La "Ventana de Tiempo a Disposición" es un período de tiempo definido por contrato. La duración estándar son 10 minutos. Una vez que el PIN del cliente o "my pasafecard" han sido asignados, una transaccón debe completarse con una llamada ""Capture Payment"" dentro de este período de tiempo o el monto reservado en el PIN del cliente o "my paysafecard" será liberado y devuelto al cliente.

12. ¿Qué ocurre si una transacción no se completa con una llamada "Capture Payment"?

    Una transacción no se puede completar con éxito sin una llamada "Capture Payment". El monto de la transacción reservado en el PIN del cliente o en "my paysafecard" será liberado. En tal caso una vez que se ha completado la ventana de tiempo a disposición, la transacción falla.

13. ¿Se puede usar HTTPS como Payment Notification URL (pnURL)?

    Sí, si se trata de un certificado emitido por una entidad de certificación oficial (por ejemplo Thawte y Verisign ).

14. ¿Dónde encuentro un código de muestra para REST API de paysafecard?

    Los códigos de muestra para REST API de paysefacard están disponibles en el área de descarga en nuestro sitio web.

15. ¿Cómo cambio a entorno de producción?

    Para cambiar a entorno de producción, deberá introducir la clave API de producción y cambiar los puntos finales a producción. En MSC puede encontrar y crear nuevas claves API y también encontrará los puntos finales.

    Por favor, observe que antes de que pueda ver esta información de producción deberá completar las pruebas de integración automatizadas en MSC (excepto si está utilizando un plugin o portal de pago verificados). Asimismo, el contrato debe ser firmado y nosotros debemos completar algunos pasos comerciales internos.

16. ¿Para qué sirve la prueba de funciones?

    La prueba de funciones solamente se lleva a cabo si usted implementó un pago o reembolso. Su propósito es comprobar que estos servicios se hayan implementado correctamente.

    Tras completar las pruebas de integración automatizadas en el MSC usted puede solicitar la prueba de funciones. Esta prueba la realiza manualmente nuestro personal y para realizarla necesitaremos acceder a su entorno de pruebas.

17. ¿Para qué sirve la prueba de aceptación en el sistema de producción?

    La prueba de aceptación se realiza para garantizar que los pagos con paysafecard se estén realizando según lo esperado. Nuestro personal realiza esta prueba manualmente. Además de verificar que los pagos con paysafecard sigan el flujo de pagos (https://www.paysafecard.com/fileadmin/api/#/reference/payment-process) también comprobamos que los mensajes de éxito/error se muestren adecuadamente al cliente y verificamos la utilización de los logos de paysafecard.

18. ¿Cómo funciona la prueba de integración en el sistema de prueba?

    Tras la integración del REST-API en su sistema de prueba, se le solicitará poner a prueba su implementación. Para ello, el MSC le facilitará una serie de casos de prueba para garantizar la plena funcionalidad de la aplicación de pagos de paysafecard.

    Estos casos de prueba descritos en detalle deben realizarse en tiempo real y en el orden especificado por MSC. Los resultados de las prueba se comprobarán a continuación por el sistema de prueba de paysafecard. A continuación recibirá un protocolo de prueba que resume todos los detalles del caso de prueba y le informa sobre los ajustes que le quedan por realizar, si procede.

19. ¿Qué son las claves REST API?

    Para poder acceder a nuestro sistema, usted necesita datos de acceso. Y, se los conoce como clave API. Puede encontrar su clave API en el MSC.

    Estos datos de acceso sirven para fines de verificación en nuestra REST API y deben introducirse en su sistema como paso requerido en el curso de la implementación técnica de paysafecard.

    Tenga en cuenta que usted está comprometido a mantener en secreto esta clave y a protegerla contra el acceso de terceros. paysafecard no asume ninguna responsabilidad por daños que resulten de un uso abusivo de los datos de acceso.

20. ¿Para qué debo hacer que paysafecard autorice mis direcciones IP?

    Por motivos de seguridad, nuestro sistema productivo solo permite accesos desde direcciones IP autorizadas. Por tanto, le rogamos que en el paso de proceso «IP Whitelisting» nos dé a conocer las direcciones IP con las que desea acceder a nuestro sistema productivo.